说明
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 QLineEditline_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;}
""")