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)

这是一个重载函数。

使用给定的icon 在position 创建一个新动作。

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 为 true，则也会选中该字。

另请参阅 cursorWordForward() 。

void QLineEdit::cursorWordForward(bool mark)

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

另请参阅 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()

使用回车或回车键时，或行编辑器失去焦点且其内容自上次发出该信号后发生变化时，都会发出该信号。

void QLineEdit::end(bool mark)

将文本光标移到行尾，除非光标已经在行尾。如果mark 为 true，则会选择最后一个位置的文本。否则，如果光标被移动，任何选中的文本都将取消选中。

另请参阅 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 为 true，则文本会被选中到第一个位置。否则，如果光标移动，任何选中的文本都将取消选中。

另请参阅 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()

如果重做是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 。

行编辑的returnPressed() 和editingFinished() 信号只有在v 将行编辑的内容验证为Acceptable 时才会发出。在编辑过程中，用户可以将内容更改为任何Intermediate 值，但不能将文本编辑为v 验证为Invalid 的值。

这样既可以限制编辑完成后存储的文本，又可以让用户有足够的自由将文本从一种有效状态编辑到另一种有效状态。

要移除当前的输入验证器，请通过nullptr 。初始设置为无输入验证器（可接受任何输入，直至maxLength()).

另请参阅 validator(),hasAcceptableInput(),QIntValidator,QDoubleValidator, 和QRegularExpressionValidator 。

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

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

返回 widget 的推荐尺寸。

返回的宽度（以像素为单位）通常足以容纳 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

返回 widget 的文本边距。

另请参阅 setTextMargins()。

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

重实现：QObject::timerEvent(QTimerEvent *event).

[slot] void QLineEdit::undo()

如果撤消是available ，则撤消上次操作。取消选择任何当前选区，并将选区起始位置更新为当前光标位置。

const QValidator *QLineEdit::validator() const

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

另请参阅 setValidator().