QLineEdit

说明

QLineEdit 类的常用方法和属性

类别	方法/属性	描述
文本和输入	text()	获取或设置文本框中的文本
	setText()	设置文本框中的文本
	placeholderText()	获取或设置占位符文本
	setPlaceholderText()	设置占位符文本
	inputMask()	获取或设置输入掩码
	setInputMask()	设置输入掩码
	maxLength()	获取或设置文本框的最大长度
	setMaxLength()	设置文本框的最大长度
	acceptableInput()	检查文本框中的文本是否符合输入掩码
	hasAcceptableInput()	检查文本框中的文本是否符合输入掩码
	echoMode()	获取或设置文本框的回显模式
	setEchoMode()	设置文本框的回显模式
	isModified()	检查文本框的内容是否被修改
	setModified()	设置文本框的内容是否被修改
	isReadOnly()	检查文本框是否为只读
	setReadOnly()	设置文本框是否为只读
	isRedoAvailable()	检查是否可以重做操作
	isUndoAvailable()	检查是否可以撤销操作
	redo()	重做操作
	undo()	撤销操作
	textMargins()	获取或设置文本框的文本边距
	setTextMargins()	设置文本框的文本边距
	validator()	获取或设置文本框的验证器
	setValidator()	设置文本框的验证器
光标和选择	cursorPosition()	获取或设置光标位置
	setCursorPosition()	设置光标位置
	hasSelectedText()	检查是否有选中的文本
	selectedText()	获取选中的文本
	setSelection()	设置选中文本的范围
	selectionStart()	获取选中文本的起始位置
	selectionEnd()	获取选中文本的结束位置
	selectionLength()	获取选中文本的长度
	selectionChanged()	当选中文本改变时触发
动作和按钮	addAction()	向文本框添加动作
	isClearButtonEnabled()	检查清除按钮是否启用
	setClearButtonEnabled()	设置清除按钮是否启用
外观和样式	alignment()	获取或设置文本的对齐方式
	setAlignment()	设置文本的对齐方式
	hasFrame()	检查文本框是否有边框
	setFrame()	设置文本框是否有边框
	frame()	获取文本框的边框样式
事件和行为	cursorMoveStyle()	获取或设置光标移动样式
	setCursorMoveStyle()	设置光标移动样式
	cursorPositionChanged()	当光标位置改变时触发
	cursorPositionAt()	获取指定位置的光标位置
	cursorRect()	获取光标的矩形区域
	cursorBackward()	光标向后移动
	cursorForward()	光标向前移动
	cursorWordBackward()	光标向后移动到单词开头
	cursorWordForward()	光标向前移动到单词开头
	home()	光标移动到文本开始位置
	end()	光标移动到文本结束位置
	copy()	复制选中的文本
	cut()	剪切选中的文本
	paste()	粘贴剪贴板中的文本
	del_()	删除光标位置的字符
	backspace()	删除光标前的字符
	clear()	清除文本框中的文本
	deselect()	取消选中文本
	selectAll()	选中文本框中的所有文本
其他	redoAvailable()	当可重做操作时触发
	undoAvailable()	当可撤销操作时触发
	editingFinished()	当编辑完成时触发
	returnPressed()	当按下回车键时触发
	createStandardContextMenu()	创建标准上下文菜单
	inputMethodQuery()	查询输入法信息
	inputRejected()	当输入被拒绝时触发
	initStyleOption()	初始化样式选项

QSS样式

QLineEdit 是 PySide6 (Qt for Python) 中的一个控件，用于创建单行文本输入框。它支持 QSS（Qt样式表），允许开发者通过样式表来定制文本输入框的外观和行为。以下是一些关于 QLineEdit 的 QSS 样式属性、子控件、伪状态、选择器的详细说明：

子控件

QLineEdit 本身是一个简单的控件，通常不包含子控件。但是，它可能包含文本和图片，这些可以被视为其内容的一部分。

伪状态

伪状态用于描述控件的特定状态，如选中、悬停等：

• :hover: 当鼠标悬停在控件上时。
• :selected: 当文本被选中时。
• :disabled: 当控件被禁用时。
• :focus: 当控件拥有焦点时。
• :read-only: 当文本输入框设置为只读时。

样式属性

QLineEdit 支持多种 QSS 属性来定制其外观和行为：

• background-color: 设置文本输入框的背景颜色。
• color: 设置文本颜色。
• font: 设置文本的字体和大小。
• border: 设置文本输入框的边框样式。
• padding: 设置文本输入框内部的填充。
• margin: 设置文本输入框外部的边距。
• selection-background-color: 设置选中文本的背景颜色。
• selection-color: 设置选中文本的颜色。
• cursor-color: 设置光标颜色。
• text-align: 设置文本的对齐方式。

选择器

选择器用于选择特定的控件或控件的特定状态：

• QLineEdit: 选择所有的 QLineEdit 控件。
• QLineEdit::text: 选择 QLineEdit 控件中的文本。
• QLineEdit:hover: 选择鼠标悬停在 QLineEdit 上时的样式。
• QLineEdit:disabled: 选择被禁用的 QLineEdit 控件的样式。
• QLineEdit:read-only: 选择只读模式下的 QLineEdit 控件的样式。

示例

以下是一个使用 QSS 样式表来定制 QLineEdit 的示例：

from PySide6.QtWidgets import QLineEdit

line_edit = QLineEdit()
line_edit.setPlaceholderText("Enter text here...")
line_edit.setStyleSheet("""
    QLineEdit {
        background-color: #ffffff;
        color: #333333;
        font: 12pt Arial;
        border: 1px solid #cccccc;
        padding: 5px;
        margin: 10px;
     }
    QLineEdit:hover {
        border-color: #0000ff;
     }
    QLineEdit:disabled {
        background-color: #f0f0f0;
     }
    QLineEdit:read-only {
        background-color: #f0f0f0;
     }
""")