QLineEdit 类

成员函数文档

[显式] QLineEdit::QLineEdit(QWidget *parent = nullptr)

构造一个不带文本的行编辑。

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

parent 参数被发送到 QWidget 构造函数。

也请参阅setText() 和 setMaxLength().

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

构造一个包含文本 contents 的行编辑，作为 parent 的子项。

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

也请参阅text() 和 setMaxLength().

[虚 not except] 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为true，则移动过的每个字符都将添加到选中内容中。如果mark为false，则清除选中内容。

另请参阅 cursorForward()。

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

将光标向前移动steps个字符。如果mark为true，则每个移动过的字符都添加到选中区域中。如果mark为false，则清除选中区域。

另请参阅cursorBackward。

int QLineEdit::cursorPositionAt(const QPoint &pos)

返回点pos下的光标位置。

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

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

另请参阅setCursorPosition()和cursorPosition。

[保护] QRect QLineEdit::cursorRect() const

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

void QLineEdit::cursorWordBackward(bool mark)

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

另请参阅cursorWordForward。

void QLineEdit::cursorWordForward(bool mark)

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

另请参阅cursorWordBackward。

[槽] void QLineEdit::cut()

将选中文本复制到剪贴板，如果存在则删除。如果echoMode()是正常。

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

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

void QLineEdit::del()

如果没有文本被选中，删除文本光标右侧的字符。如果有任何文本被选中，光标将移动到选中文本的开始处，并删除选中文本。

另请参阅backspace。

void QLineEdit::deselect()

取消任何选中文本。

另请参阅setSelection()和selectAll。

[覆盖虚保护] void QLineEdit::dragEnterEvent(QDragEnterEvent *e)

重新实现了：QWidget::dragEnterEvent(QDragEnterEvent *event)。

[重写虚保护] void QLineEdit::dragLeaveEvent(QDragLeaveEvent *e)

重写: QWidget::dragLeaveEvent(QDragLeaveEvent *event).

[重写虚保护] void QLineEdit::dragMoveEvent(QDragMoveEvent *e)

重写: QWidget::dragMoveEvent(QDragMoveEvent *event).

[重写虚保护] void QLineEdit::dropEvent(QDropEvent *e)

重写: QWidget::dropEvent(QDropEvent *event).

[信号] void QLineEdit::editingFinished()

当使用 Return 或 Enter 键，或者如果文本编辑框失去焦点且其内容自上次发出此信号以来已更改时，将发出此信号。

void QLineEdit::end(bool mark)

将文本光标移到行尾，除非它已经在那里。如果 mark 为 true，则选择文本到最后的位置。否则，如果移动光标，则取消选择任何选定的文本。

另请参阅：home().

[重写虚] bool QLineEdit::event(QEvent *e)

重写: QWidget::event(QEvent *event).

[重写虚保护] void QLineEdit::focusInEvent(QFocusEvent *e)

重写: QWidget::focusInEvent(QFocusEvent *event).

[重写虚保护] void QLineEdit::focusOutEvent(QFocusEvent *e)

重写: QWidget::focusOutEvent(QFocusEvent *event).

void QLineEdit::home(bool mark)

将文本光标移到行首，除非它已经在那里。如果 mark 为 true，则选择文本到第一个位置。否则，如果移动光标，则取消选择任何选定的文本。

另请参阅：end().

[虚保护] void QLineEdit::initStyleOption(QStyleOptionFrame *option) const

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

另请参阅：QStyleOption::initFrom().

[重写虚受保护] void QLineEdit::inputMethodEvent(QInputMethodEvent *e)

重新实现: QWidget::inputMethodEvent(QInputMethodEvent *event).

[重写虚] QVariant QLineEdit::inputMethodQuery(Qt::InputMethodQuery property) const

重新实现: QWidget::inputMethodQuery(Qt::InputMethodQuery query) const.

[信号] void QLineEdit::inputRejected()

当用户使用被视为无效输入的键时，将发出此信号。例如，如果使用键导致校验器的 validate() 调用返回 Invalid。另一种情况是在尝试输入比行编辑的最大长度更多的字符时。

void QLineEdit::insert(const QString &newText)

删除任何选中的文本，插入 newText，并校验结果。如果它是有效的，则将新文本设置为行编辑的新内容。

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

[重写虚受保护] void QLineEdit::keyPressEvent(QKeyEvent *event)

重新实现: QWidget::keyPressEvent(QKeyEvent *event).

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

如果使用了 Return 或 Enter，并且当前文本有效（或可以通过校验器 调整为有效），则发出信号 returnPressed。

另请参阅默认按键绑定。

[重写虚受保护] void QLineEdit::keyReleaseEvent(QKeyEvent *e)

重新实现: QWidget::keyReleaseEvent(QKeyEvent *event).

[重写虚] QSize QLineEdit::minimumSizeHint() const

重新实现属性的访问函数： QWidget::minimumSizeHint.

返回行编辑的最小尺寸。

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

[重写虚受保护] void QLineEdit::mouseDoubleClickEvent(QMouseEvent *e)

重新实现: QWidget::mouseDoubleClickEvent(QMouseEvent *event).

[重写虚受保护] void QLineEdit::mouseMoveEvent(QMouseEvent *e)

重实：QWidget::mouseMoveEvent(QMouseEvent *event)。

[重写 虚保护] void QLineEdit::mousePressEvent(QMouseEvent *e)

重实：QWidget::mousePressEvent(QMouseEvent *event)。

[重写 虚保护] void QLineEdit::mouseReleaseEvent(QMouseEvent *e)

重实：QWidget::mouseReleaseEvent(QMouseEvent *event)。

[槽] void QLineEdit::paintEvent(QPaintEvent *)

重实：QWidget::paintEvent(QPaintEvent *event)。

[槽] void QLineEdit::paste()

将剪贴板的文本插入到光标位置，删除任何已选文本，如果行编辑不是只读的。

如果最终结果对当前 验证器 无效，则不会发生任何操作。

另请参阅copy() 和 cut。

[槽] void QLineEdit::redo()

如果重做操作可用，将重做最后的操作。

[信号] void QLineEdit::returnPressed()

当使用 Return 或 Enter 键时发出此信号。

[槽] void QLineEdit::selectAll()

选择所有文本（突出显示）并将光标移动到末尾。

另请参阅setSelection() 和 deselect。

[信号] 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(int left, int top, int right, int bottom)

设置框内文本周围的边距为 left，top，right 和 bottom。

另请参阅 textMargins。

void QLineEdit::setTextMargins(const QMargins &margins)

设置框内文本的 margins。

另请参阅 textMargins。

void QLineEdit::setValidator(const QValidator *v)

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

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

这允许您在完成编辑时约束将要存储的文本，同时使用户有足够的自由从一种有效状态编辑文本到另一种有效状态。

要删除当前输入验证器，传递 nullptr。初始设置是不具有输入验证器（接受任何输入直至 maxLength()）。

另请参阅 validator，hasAcceptableInput，QIntValidator，QDoubleValidator，以及 QRegularExpressionValidator。

[覆盖虚函数] QSize QLineEdit::sizeHint() const

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

返回该小部件的推荐大小。

返回的宽度，以像素为单位，通常足以容纳大约15到20个字符。

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

每次文本更改时都会发射此信号。参数text是新的文本。

与textEdited不同，此信号在文本被程序更改时也会发射，例如，通过调用setText()。

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

每次编辑文本时都会发射此信号。参数text是新的文本。

与textChanged不同，此信号在文字通过调用setText()程序更改时不会发射。

QMargins QLineEdit::textMargins() const

返回小部件的文本边距。

另请参阅： setTextMargins()。

[覆盖虚函数] void QLineEdit::timerEvent(QTimerEvent *e)

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

[槽函数] void QLineEdit::undo()

如果可以撤销，则撤销最后一次操作。取消选择任何当前选择，并更新选择开始到当前光标位置。

const QValidator *QLineEdit::validator() const

返回指向当前输入验证器的指针，或者如果没有设置验证器，则为 nullptr。

另请参阅： setValidator()。