【PySide6快速入门】QLineEdit 输入框

文章目录

- - PySide6快速入门：QLineEdit 输入框
  - - 前言
    - 主题：QLineEdit 的使用
  - 1. 什么是 QLineEdit？
  - 2. QLineEdit 的常用功能
  - 3. QLineEdit 基本用法
  - 4. QLineEdit 常用函数
  - - 4.1 基本操作
    - 4.2 事件和输入控制
    - 4.3 信号和槽
  - 5. QLineEdit 示例：密码输入框
  - 总结

PySide6快速入门：QLineEdit 输入框

前言

QLineEdit 是 PySide6 中一个非常常用的控件，它用于接收单行文本输入。无论是表单填写、搜索框，还是其他需要用户输入的场景，QLineEdit 都是必不可少的控件。它不仅支持文本输入，还可以进行文本验证、光标位置控制等操作。本文将介绍 QLineEdit 的基本用法及常用函数，帮助您在 PySide6 中快速上手使用该控件。

主题：QLineEdit 的使用

1. 什么是 QLineEdit？

QLineEdit 是一个提供单行文本输入的控件，通常用于获取用户输入。它支持文本的修改、显示、选择以及格式化，也可以进行自定义验证和输入提示。QLineEdit 常见的用途包括登录框中的用户名输入框、搜索框、设置页中的字段等。

2. QLineEdit 的常用功能

QLineEdit 提供了很多功能，例如：

获取和设置文本：可以轻松获取用户输入的文本或设置默认文本。
占位符文本：可以设置占位符提示用户输入。
回车事件：可以通过监听回车键事件来触发特定操作。
文本选择：可以对输入的文本进行选择、复制、剪切等操作。
密码输入：可以使用 QLineEdit 来输入密码，隐藏用户的输入。
输入验证：可以对输入进行验证，例如限制输入长度、格式等。

3. QLineEdit 基本用法

import sys
from PySide6.QtWidgets import QApplication, QWidget, QVBoxLayout, QLineEdit, QPushButtonclass Example(QWidget):def __init__(self):super().__init__()# 设置窗口self.setWindowTitle("QLineEdit 示例")self.setGeometry(100, 100, 300, 150)# 创建 QLineEdit 输入框self.line_edit = QLineEdit(self)self.line_edit.setPlaceholderText("请输入文本...")# 创建按钮self.button = QPushButton("获取输入", self)self.button.clicked.connect(self.show_text)# 布局管理layout = QVBoxLayout()layout.addWidget(self.line_edit)layout.addWidget(self.button)self.setLayout(layout)def show_text(self):# 获取 QLineEdit 输入框中的文本text = self.line_edit.text()print(f"输入的文本是: {text}")if __name__ == "__main__":app = QApplication(sys.argv)window = Example()window.show()sys.exit(app.exec())

上述代码展示了一个简单的例子，创建了一个包含 QLineEdit 和按钮的窗口。当按钮被点击时，程序获取输入框中的文本并打印到控制台。

4. QLineEdit 常用函数

4.1 基本操作

setText(text: str)
- 作用：设置文本框中的文本。
- 参数：text：要设置的文本字符串。
- 返回值：无
```
line_edit.setText("新的文本")
```
text()
- 作用：获取文本框中的文本。
- 返回值：str：当前文本框中的文本。
```
input_text = line_edit.text()
```
setPlaceholderText(text: str)
- 作用：设置占位符文本，当文本框为空时显示。
- 参数：text：占位符文本字符串。
- 返回值：无
```
line_edit.setPlaceholderText("请输入内容...")
```
clear()
- 作用：清除文本框中的文本。
- 返回值：无
```
line_edit.clear()
```

4.2 事件和输入控制

setEchoMode(mode: EchoMode)
- 作用：设置输入框的回显模式。常用于密码输入框，隐藏用户输入的字符。
- 参数：
  - QLineEdit.Normal: 正常模式，字符可见。
  - QLineEdit.Password: 密码模式，输入的字符会显示为 *。
  - QLineEdit.NoEcho: 无回显，不显示输入的字符。
- 返回值：无
```
line_edit.setEchoMode(QLineEdit.Password)
```
setMaxLength(length: int)
- 作用：设置最大输入长度，超过该长度的文本将无法被输入。
- 参数：length：最大输入长度。
- 返回值：无
```
line_edit.setMaxLength(20)
```
hasAcceptableInput()
- 作用：判断输入框中的文本是否符合规定的格式，通常与验证器一起使用。
- 返回值：bool：如果输入有效，则返回 True，否则返回 False。
```
if line_edit.hasAcceptableInput():print("输入有效")
```

4.3 信号和槽

QLineEdit 提供了一些信号，您可以通过连接这些信号来响应用户的操作。

textChanged
- 作用：文本内容发生改变时触发。
- 返回值：无
```
line_edit.textChanged.connect(self.on_text_changed)
```
editingFinished
- 作用：当用户编辑完成并按下回车键时触发，或者文本框失去焦点时触发。
- 返回值：无
```
line_edit.editingFinished.connect(self.on_editing_finished)
```
returnPressed
- 作用：当按下回车键时触发。
- 返回值：无
```
line_edit.returnPressed.connect(self.on_return_pressed)
```

5. QLineEdit 示例：密码输入框

import sys
from PySide6.QtWidgets import QApplication, QWidget, QVBoxLayout, QLineEdit, QPushButtonclass Example(QWidget):def __init__(self):super().__init__()self.setWindowTitle("QLineEdit 密码输入框")self.setGeometry(100, 100, 300, 150)# 创建密码输入框self.line_edit = QLineEdit(self)self.line_edit.setPlaceholderText("请输入密码...")self.line_edit.setEchoMode(QLineEdit.Password)# 创建按钮self.button = QPushButton("提交密码", self)self.button.clicked.connect(self.show_password)# 布局管理layout = QVBoxLayout()layout.addWidget(self.line_edit)layout.addWidget(self.button)self.setLayout(layout)def show_password(self):# 获取密码并打印password = self.line_edit.text()print(f"输入的密码是: {password}")if __name__ == "__main__":app = QApplication(sys.argv)window = Example()window.show()sys.exit(app.exec())