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