QLineEdit 是 PyQt6 或 PySide6 库中用于输入单行文本的控件。它是一个非常常用且功能丰富的控件，适用于各种需要用户输入文本的场景，如用户名、密码、搜索框等。QLineEdit 提供了丰富的属性和方法，使得开发者可以轻松地控制和处理用户的输入。下面我将详细介绍 QLineEdit 的主要特性及其使用方法。

1. 基本概念

• 单行文本编辑器：用户可以在其中输入和编辑单行文本。
• 占位符文本：在没有输入时显示的提示文本。
• 输入掩码：限制用户输入的格式（例如电话号码、日期等）。
• 验证器：用于验证用户输入的内容是否符合特定规则。
• 回显模式：控制文本的显示方式（例如密码输入时隐藏字符）。

2. 创建 QLineEdit 实例

要使用 QLineEdit，首先需要导入相应的库：

from PyQt6.QtWidgets import QApplication, QLineEdit, QVBoxLayout, QWidget
# 或者
from PySide6.QtWidgets import QApplication, QLineEdit, QVBoxLayout, QWidget

接着创建一个窗口，并在其中添加 QLineEdit 控件：

class MyWindow(QWidget):def __init__(self):super().__init__()self.setWindowTitle("我的应用程序")self.setGeometry(100, 100, 400, 300)# 初始化UIself.initUI()def initUI(self):layout = QVBoxLayout()# 创建文本输入框line_edit = QLineEdit(self)line_edit.setPlaceholderText("请输入文本...")# 添加到布局layout.addWidget(line_edit)self.setLayout(layout)if __name__ == "__main__":app = QApplication([])window = MyWindow()window.show()app.exec()

3. QLineEdit 的常用属性和方法

属性

• text：获取或设置当前的文本内容。
• placeholderText：获取或设置占位符文本。
• maxLength：获取或设置最大输入长度。
• echoMode：获取或设置回显模式（普通、密码、无回显等）。
• cursorPosition：获取或设置光标位置。
• alignment：获取或设置文本对齐方式。
• readOnly：获取或设置是否只读。
• frame：获取或设置是否有边框。
• inputMask：获取或设置输入掩码。
• validator：获取或设置验证器。
• toolTip：获取或设置工具提示文本。
• statusTip：获取或设置状态栏提示文本。

方法

• setText(str)：设置文本内容。
• text() -> str：获取文本内容。
• setPlaceholderText(str)：设置占位符文本。
• placeholderText() -> str：获取占位符文本。
• setMaxLength(int)：设置最大输入长度。
• maxLength() -> int：获取最大输入长度。
• setEchoMode(QLineEdit.EchoMode)：设置回显模式。
• echoMode() -> QLineEdit.EchoMode：获取回显模式。
• setCursorPosition(int)：设置光标位置。
• cursorPosition() -> int：获取光标位置。
• setAlignment(Qt.AlignmentFlag)：设置文本对齐方式。
• alignment() -> Qt.AlignmentFlag：获取文本对齐方式。
• setReadOnly(bool)：设置是否只读。
• isReadOnly() -> bool：判断是否只读。
• setFrame(bool)：设置是否有边框。
• hasFrame() -> bool：判断是否有边框。
• setInputMask(str)：设置输入掩码。
• inputMask() -> str：获取输入掩码。
• setValidator(QValidator)：设置验证器。
• validator() -> QValidator：获取验证器。
• setToolTip(str)：设置工具提示文本。
• toolTip() -> str：获取工具提示文本。
• setStatusTip(str)：设置状态栏提示文本。
• statusTip() -> str：获取状态栏提示文本。
• clear()：清除文本内容。
• selectAll()：全选文本。
• deselect()：取消选择文本。

4. 详细示例

设置文本和占位符文本

line_edit = QLineEdit(self)
line_edit.setText("初始文本")
line_edit.setPlaceholderText("请输入文本...")

设置最大输入长度

line_edit = QLineEdit(self)
line_edit.setMaxLength(10)  # 最多输入10个字符

设置回显模式

line_edit = QLineEdit(self)
line_edit.setEchoMode(QLineEdit.EchoMode.Password)  # 密码模式

设置文本对齐方式

line_edit = QLineEdit(self)
line_edit.setAlignment(Qt.AlignmentFlag.AlignCenter)  # 居中对齐

设置只读

line_edit = QLineEdit(self)
line_edit.setReadOnly(True)  # 只读模式

设置输入掩码

line_edit = QLineEdit(self)
line_edit.setInputMask("000-000-0000")  # 电话号码格式

设置验证器

from PyQt6.QtGui import QIntValidator, QDoubleValidator, QRegularExpressionValidator
# 或者
from PySide6.QtGui import QIntValidator, QDoubleValidator, QRegularExpressionValidatorline_edit = QLineEdit(self)
int_validator = QIntValidator(0, 99)  # 仅允许输入0到99之间的整数
line_edit.setValidator(int_validator)double_validator = QDoubleValidator(0.0, 99.99, 2)  # 仅允许输入0.00到99.99之间的浮点数
line_edit.setValidator(double_validator)regex_validator = QRegularExpressionValidator(QRegularExpression(r"^[a-zA-Z]+$"))  # 仅允许输入字母
line_edit.setValidator(regex_validator)

设置工具提示和状态栏提示

line_edit = QLineEdit(self)
line_edit.setToolTip("这是一个输入框")
line_edit.setStatusTip("输入您的信息")

清除文本内容

line_edit.clear()

全选文本

line_edit.selectAll()

取消选择文本

line_edit.deselect()

5. 信号与槽机制

QLineEdit 支持多种信号，这些信号可以在用户交互时发射。常见的信号包括 textChanged、textEdited 和 returnPressed。你可以通过连接这些信号到槽函数来处理用户的输入事件。

def on_text_changed(text):print(f"文本改变: {text}")def on_text_edited(text):print(f"文本编辑: {text}")def on_return_pressed():print("回车键被按下")line_edit = QLineEdit(self)
line_edit.textChanged.connect(on_text_changed)
line_edit.textEdited.connect(on_text_edited)
line_edit.returnPressed.connect(on_return_pressed)

6. 自定义样式

除了使用内置的样式设置外，你还可以通过样式表（QSS）来自定义 QLineEdit 的外观。样式表类似于CSS，提供了强大的样式控制能力。

line_edit = QLineEdit(self)
line_edit.setStyleSheet("""QLineEdit {background-color: #f0f0f0;border: 1px solid #cccccc;padding: 10px;font-size: 16px;color: #333333;}QLineEdit:focus {border: 1px solid #0078d7;}
""")

7. 动态更新和控制

你可以动态地更新 QLineEdit 的内容，或者根据某些条件控制其行为。例如，在定时器或其他事件触发时更新文本内容。

import time
from PyQt6.QtCore import QTimerclass MyWindow(QWidget):def __init__(self):super().__init__()self.setWindowTitle("我的应用程序")self.setGeometry(100, 100, 400, 300)# 初始化UIself.initUI()# 创建定时器self.timer = QTimer(self)self.timer.timeout.connect(self.update_line_edit)self.timer.start(1000)  # 每秒触发一次def initUI(self):layout = QVBoxLayout()# 创建文本输入框self.line_edit = QLineEdit(self)self.line_edit.setPlaceholderText("时间: 00:00:00")# 添加到布局layout.addWidget(self.line_edit)self.setLayout(layout)def update_line_edit(self):current_time = time.strftime("%H:%M:%S", time.localtime())self.line_edit.setText(f"时间: {current_time}")if __name__ == "__main__":app = QApplication([])window = MyWindow()window.show()app.exec()

总结

QLineEdit 是 PyQt6/PySide6 中非常基础且灵活的控件，适用于各种需要用户输入文本的场景。通过设置不同的属性和使用样式表，你可以创建出丰富多样的文本输入框样式。同时，通过信号与槽机制，你可以方便地处理用户的输入事件。希望以上内容能帮助你更好地理解和运用 QLineEdit，并能够根据具体需求创建出功能丰富且用户友好的文本输入控件。