QLineEdit Class

成员函数文档

[explicit] QLineEdit::QLineEdit(QWidget *parent = nullptr)

创建一个不含文本的行编辑控件。

文本的最大长度设置为 32767 个字符。

parent 参数将传递给QWidget 构造函数。

另请参阅 setText() 和setMaxLength()。

[explicit] QLineEdit::QLineEdit(const QString &contents, QWidget *parent = nullptr)

创建一个包含文本“contents ”的行编辑控件，并将其作为parent 的子控件。

光标位置设置为行尾，最大文本长度设置为 32767 个字符。

另请参阅 text() 和setMaxLength()。

[virtual noexcept] QLineEdit::~QLineEdit()

清除行编辑内容。

void QLineEdit::addAction(QAction *action, QLineEdit::ActionPosition position)

将“action ”添加到position 中的操作列表中。

QAction *QLineEdit::addAction(const QIcon &icon, QLineEdit::ActionPosition position)

在position 上，使用给定的icon 创建一个新的操作。

void QLineEdit::backspace()

如果未选中任何文本，则删除文本光标左侧的字符，并将光标向左移动一个位置。如果选中了任何文本，则将光标移至所选文本的开头，并删除所选文本。

另请参阅 del()。

[override virtual protected] void QLineEdit::changeEvent(QEvent *ev)

重写了：QWidget::changeEvent(QEvent *event)。

[slot] void QLineEdit::clear()

清除行编辑框中的内容。

另请参阅 setText() 和insert()。

QCompleter *QLineEdit::completer() const

返回当前提供补全功能的QCompleter 。

另请参阅 setCompleter()。

[override virtual protected] void QLineEdit::contextMenuEvent(QContextMenuEvent *event)

重写：QWidget::contextMenuEvent(QContextMenuEvent *event)。

显示由createStandardContextMenu() 创建的标准上下文菜单。

若不希望行编辑框具有上下文菜单，可将其contextMenuPolicy 属性设置为Qt::NoContextMenu 。若要自定义上下文菜单，请重写此函数。若要扩展标准上下文菜单，请重写此函数，调用createStandardContextMenu()，并扩展返回的菜单。

void LineEdit::contextMenuEvent(QContextMenuEvent *event)
{
    QMenu *menu = createStandardContextMenu();
    menu->addAction(tr("My Menu Item"));
    //...
    menu->exec(event->globalPos());
    delete menu;
}

event 参数用于获取事件发生时鼠标光标的位置。

另请参阅 setContextMenuPolicy()。

[slot] void QLineEdit::copy() const

将选中的文本复制到剪贴板（如果存在选中内容），且当调用echoMode()时，该函数返回Normal 。

另请参阅 cut() 和paste()。

QMenu *QLineEdit::createStandardContextMenu()

创建标准上下文菜单，当用户用鼠标右键单击行编辑框时，该菜单会显示出来。该函数由默认的contextMenuEvent()处理程序调用。弹出菜单的所有权将转移给调用方。

void QLineEdit::cursorBackward(bool mark, int steps = 1)

将光标向后移动steps 个字符。如果mark 为真，则移动到的每个字符都会被添加到选区中；如果mark 为假，则清空选区。

另请参阅 cursorForward()。

void QLineEdit::cursorForward(bool mark, int steps = 1)

将光标向前移动steps 个字符。如果mark 为真，则移动到的每个字符都会被添加到选区中；如果mark 为假，则清空选区。

另请参阅 cursorBackward()。

int QLineEdit::cursorPositionAt(const QPoint &pos)

返回光标位于点pos 下方的位置。

[signal] void QLineEdit::cursorPositionChanged(int oldPos, int newPos)

每当光标移动时，都会发出此信号。先前位置由oldPos 给出，新位置由newPos 给出。

另请参阅 setCursorPosition() 和cursorPosition()。

[protected] QRect QLineEdit::cursorRect() const

返回一个包含行编辑光标的矩形。

void QLineEdit::cursorWordBackward(bool mark)

将光标向后移动一个单词。如果mark 为真，则该单词也会被选中。

另请参阅 cursorWordForward()。

void QLineEdit::cursorWordForward(bool mark)

将光标向前移动一个单词。如果mark 为真，则该单词也会被选中。

另请参阅 cursorWordBackward()。

[slot] void QLineEdit::cut()

将选中的文本复制到剪贴板，并删除剪贴板中的内容（如有），前提是echoMode()的返回值为Normal 。

如果当前验证器不允许删除所选文本，则 cut() 将仅复制而不删除。

另请参阅 copy()、paste() 和setValidator()。

void QLineEdit::del()

如果未选中任何文本，则删除文本光标右侧的字符。如果选中了文本，则光标移至所选文本的开头，并删除所选文本。

另请参阅 backspace()。

void QLineEdit::deselect()

取消选中任何已选中的文本。

另请参阅 setSelection() 和selectAll()。

[override virtual protected] void QLineEdit::dragEnterEvent(QDragEnterEvent *e)

重写了：QWidget::dragEnterEvent(QDragEnterEvent *event)。

[override virtual protected] void QLineEdit::dragLeaveEvent(QDragLeaveEvent *e)

重写了：QWidget::dragLeaveEvent(QDragLeaveEvent *event)。

[override virtual protected] void QLineEdit::dragMoveEvent(QDragMoveEvent *e)

重写了：QWidget::dragMoveEvent(QDragMoveEvent *event)。

[override virtual protected] void QLineEdit::dropEvent(QDropEvent *e)

重写了：QWidget::dropEvent(QDropEvent *event)。

[signal] void QLineEdit::editingFinished()

当按下回车键或Enter键时，或者当行编辑框失去焦点且其内容自上次发出此信号以来已发生变化时，会发出此信号。

void QLineEdit::end(bool mark)

将文本光标移至行尾（除非光标已位于行尾）。如果mark 为真，则向行尾方向选中文本。否则，如果光标移动，则任何已选中的文本将被取消选中。

另请参阅 home()。

[override virtual] bool QLineEdit::event(QEvent *e)

重写了：QWidget::event(QEvent *event)。

[override virtual protected] void QLineEdit::focusInEvent(QFocusEvent *e)

重写了：QWidget::focusInEvent(QFocusEvent *event)。

[override virtual protected] void QLineEdit::focusOutEvent(QFocusEvent *e)

重写了：QWidget::focusOutEvent(QFocusEvent *event)。

void QLineEdit::home(bool mark)

将文本光标移至行首（除非光标已位于行首）。如果mark 为真，则向行首方向选中文本。否则，如果光标被移动，则任何已选中的文本将被取消选中。

另请参阅 end()。

[virtual protected] void QLineEdit::initStyleOption(QStyleOptionFrame *option) const

使用QLineEdit 中的值初始化option 。当子类需要QStyleOptionFrame 时，但又不想自己填写所有信息，此方法非常有用。

另请参阅 QStyleOption::initFrom()。

[override virtual protected] void QLineEdit::inputMethodEvent(QInputMethodEvent *e)

重写了：QWidget::inputMethodEvent(QInputMethodEvent *event)。

[override virtual] QVariant QLineEdit::inputMethodQuery(Qt::InputMethodQuery property) const

重写了：QWidget::inputMethodQuery （Qt::InputMethodQuery query）const。

[signal] void QLineEdit::inputRejected()

当用户使用一个不被视为有效输入的键时，会触发此信号。例如，如果使用某个键导致验证器的validate()调用返回Invalid 。另一种情况是，当尝试输入的字符数量超过行编辑框的最大长度时。

void QLineEdit::insert(const QString &newText)

删除所选文本，插入newText ，并验证结果。如果结果有效，则将新文本设置为行编辑框的新内容。

另请参阅 setText() 和clear()。

[override virtual protected] void QLineEdit::keyPressEvent(QKeyEvent *event)

重写：QWidget::keyPressEvent(QKeyEvent *event)。

将给定的按键事件event 转换为行编辑操作。

如果按下了 Return 或 Enter 键，且当前文本有效（或可通过验证器made valid 验证为有效），则会发出信号returnPressed()。

另请参阅 Default Key Bindings 。

[override virtual protected] void QLineEdit::keyReleaseEvent(QKeyEvent *e)

重写了：QWidget::keyReleaseEvent(QKeyEvent *event)。

[override virtual] QSize QLineEdit::minimumSizeHint() const

重新实现了属性QWidget::minimumSizeHint 的访问函数。

返回行编辑框的最小尺寸。

返回的宽度通常足以容纳至少一个字符。

[override virtual protected] void QLineEdit::mouseDoubleClickEvent(QMouseEvent *e)

重写了：QWidget::mouseDoubleClickEvent(QMouseEvent *event)。

[override virtual protected] void QLineEdit::mouseMoveEvent(QMouseEvent *e)

重写了：QWidget::mouseMoveEvent(QMouseEvent *event)。

[override virtual protected] void QLineEdit::mousePressEvent(QMouseEvent *e)

重写了：QWidget::mousePressEvent(QMouseEvent *event)。

[override virtual protected] void QLineEdit::mouseReleaseEvent(QMouseEvent *e)

重写了：QWidget::mouseReleaseEvent(QMouseEvent *event)。

[override virtual protected] void QLineEdit::paintEvent(QPaintEvent *)

重写了：QWidget::paintEvent(QPaintEvent *event)。

[slot] void QLineEdit::paste()

将剪贴板中的文本插入到光标位置，并删除任何已选中的文本，前提是该行编辑框未被read-only 。

如果最终结果对当前的validator 而言无效，则不会执行任何操作。

另请参阅 copy() 和cut()。

[slot] void QLineEdit::redo()

如果 `redo` 的值为 `available`，则重做上一次操作。

[signal] void QLineEdit::returnPressed()

当按下“返回”或“回车”键时，会发出此信号。

[slot] void QLineEdit::selectAll()

选中所有文本（将其高亮显示），并将光标移至末尾。

另请参阅 setSelection() 和deselect()。

[signal] void QLineEdit::selectionChanged()

每当选择内容发生变化时，都会发出此信号。

另请参阅 hasSelectedText() 和selectedText()。

int QLineEdit::selectionEnd() const

返回行编辑框中选区后紧接着的字符的索引（如果未选中任何文本，则返回 -1）。

另请参阅 selectedText()、selectionStart() 和selectionLength()。

int QLineEdit::selectionLength() const

返回所选内容的长度。

另请参阅 selectedText()、selectionStart()，以及selectionEnd()。

int QLineEdit::selectionStart() const

返回行编辑框中首个被选中字符的索引（如果未选中任何文本，则返回 -1）。

另请参阅 selectedText()、selectionEnd() 和selectionLength()。

void QLineEdit::setCompleter(QCompleter *c)

将此行编辑框设置为从补全器c 获取自动补全。补全模式通过QCompleter::setCompletionMode() 进行设置。

若要将QCompleter 与QValidator 或QLineEdit::inputMask 配合使用，需确保提供给QCompleter 的模型包含有效的条目。您可以使用QSortFilterProxyModel 来确保QCompleter 的模型仅包含有效的条目。

要移除自动补全组件并禁用自动补全功能，请传入一个nullptr 。

另请参阅 completer() 和QCompleter 。

void QLineEdit::setSelection(int start, int length)

从位置start 开始，选取length 个字符的文本。允许使用负长度。

另请参阅 deselect()、selectAll() 和selectedText()。

void QLineEdit::setTextMargins(const QMargins &margins)

设置框架内文本的margins 属性。

另请参阅 textMargins()。

void QLineEdit::setTextMargins(int left, int top, int right, int bottom)

将框架内文本四周的边距分别设置为left 、top 、right 和bottom 。

另请参阅 textMargins()。

void QLineEdit::setValidator(const QValidator *v)

将行编辑框值的验证器设置为v 。

只有当v 将行编辑框的内容验证为Acceptable 时，该行编辑框的returnPressed()和editingFinished()信号才会被触发。用户在编辑过程中可以将内容更改为任何Intermediate 值，但系统会阻止用户将文本编辑为v 验证为Invalid 的值。

这使您能够限制编辑完成后将要存储的文本，同时让用户拥有足够的自由度，将文本从一种有效状态编辑为另一种有效状态。

要移除当前的输入验证器，请传递nullptr 。初始设置是不使用任何输入验证器（接受任何输入，直到调用maxLength()) 为止。

另请参阅 validator()、hasAcceptableInput()、QIntValidator 、QDoubleValidator 以及QRegularExpressionValidator 。

[override virtual] QSize QLineEdit::sizeHint() const

重新实现了属性QWidget::sizeHint 的访问函数。

返回该控件的建议尺寸。

返回的宽度（以像素为单位）通常足以显示约 15 到 20 个字符。

[signal] void QLineEdit::textChanged(const QString &text)

每当文本发生变化时，都会触发此信号。text 参数即为新文本。

与textEdited()不同，当文本通过编程方式被修改时（例如调用setText()），也会触发此信号。

[signal] void QLineEdit::textEdited(const QString &text)

每当文本被编辑时，都会触发此信号。text 参数即为新文本。

与 `textChanged()` 不同，当文本通过编程方式（例如调用 `setText()`）被修改时，不会触发此信号。

QMargins QLineEdit::textMargins() const

返回控件的文本边距。

另请参阅 ` setTextMargins()`。

[override virtual] void QLineEdit::timerEvent(QTimerEvent *e)

重写了：QObject::timerEvent(QTimerEvent *event)。

[slot] void QLineEdit::undo()

如果 undo 的值为available ，则撤销上一次操作。取消当前的所有选中状态，并将选区起始位置更新为当前光标位置。

const QValidator *QLineEdit::validator() const

返回指向当前输入验证器的指针；如果未设置任何验证器，则返回nullptr 。

另请参阅 setValidator()。