QLineEdit Class

Dokumentation der Mitgliedsfunktionen

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

Konstruiert eine Zeilenbearbeitung ohne Text.

Die maximale Textlänge ist auf 32767 Zeichen festgelegt.

Das Argument parent wird an den Konstruktor QWidget gesendet.

Siehe auch setText() und setMaxLength().

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

Konstruiert eine Eingabezeile, die den Text contents als Kind von parent enthält.

Die Cursorposition wird auf das Ende der Zeile und die maximale Textlänge auf 32767 Zeichen gesetzt.

Siehe auch text() und setMaxLength().

[virtual noexcept] QLineEdit::~QLineEdit()

Zerstört die Zeilenbearbeitung.

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

Fügt die action zur Liste der Aktionen auf der position hinzu.

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

Dies ist eine überladene Funktion.

Erzeugt eine neue Aktion mit der angegebenen icon auf der position.

void QLineEdit::backspace()

Wenn kein Text markiert ist, wird das Zeichen links vom Textcursor gelöscht und der Cursor um eine Position nach links verschoben. Wenn Text markiert ist, wird der Cursor an den Anfang des markierten Textes bewegt und der markierte Text gelöscht.

Siehe auch del().

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

Reimplements: QWidget::changeEvent(QEvent *Event).

[slot] void QLineEdit::clear()

Löscht den Inhalt der Eingabezeile.

Siehe auch setText() und insert().

QCompleter *QLineEdit::completer() const

Gibt die aktuelle QCompleter zurück, die Vervollständigungen anbietet.

Siehe auch setCompleter().

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

Reimplements: QWidget::contextMenuEvent(QContextMenuEvent *event).

Zeigt das mit createStandardContextMenu() erstellte Standard-Kontextmenü an.

Wenn Sie nicht wollen, dass die Bearbeitungszeile ein Kontextmenü hat, können Sie contextMenuPolicy auf Qt::NoContextMenu setzen. Um das Kontextmenü anzupassen, implementieren Sie diese Funktion neu. Um das Standard-Kontextmenü zu erweitern, implementieren Sie diese Funktion neu, rufen createStandardContextMenu() auf und erweitern das zurückgegebene Menü.

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

Der Parameter event wird verwendet, um die Position zu ermitteln, an der sich der Mauszeiger befand, als das Ereignis erzeugt wurde.

Siehe auch setContextMenuPolicy().

[slot] void QLineEdit::copy() const

Kopiert den markierten Text in die Zwischenablage, sofern vorhanden, und wenn echoMode() Normal ist.

Siehe auch cut() und paste().

QMenu *QLineEdit::createStandardContextMenu()

Erzeugt das Standard-Kontextmenü, das angezeigt wird, wenn der Benutzer mit der rechten Maustaste auf die Bearbeitungszeile klickt. Es wird vom Standardhandler contextMenuEvent() aufgerufen. Das Eigentum an dem Popup-Menü wird an den Aufrufer übertragen.

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

Bewegt den Cursor zurück steps Zeichen. Wenn mark wahr ist, wird jedes überstrichene Zeichen zur Auswahl hinzugefügt. Wenn mark falsch ist, wird die Auswahl gelöscht.

Siehe auch cursorForward().

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

Bewegt den Cursor vorwärts steps Zeichen. Wenn mark wahr ist, wird jedes Zeichen, über das der Cursor bewegt wird, zur Auswahl hinzugefügt. Wenn mark falsch ist, wird die Auswahl gelöscht.

Siehe auch cursorBackward().

int QLineEdit::cursorPositionAt(const QPoint &pos)

Gibt die Cursorposition unter dem Punkt pos zurück.

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

Dieses Signal wird immer dann ausgegeben, wenn sich der Cursor bewegt. Die vorherige Position wird durch oldPos angegeben, die neue Position durch newPos.

Siehe auch setCursorPosition() und cursorPosition().

[protected] QRect QLineEdit::cursorRect() const

Gibt ein Rechteck zurück, das den Zeilenbearbeitungscursor einschließt.

void QLineEdit::cursorWordBackward(bool mark)

Bewegt den Cursor um ein Wort nach hinten. Wenn mark wahr ist, wird das Wort auch ausgewählt.

Siehe auch cursorWordForward().

void QLineEdit::cursorWordForward(bool mark)

Bewegt den Cursor ein Wort weiter. Wenn mark wahr ist, wird das Wort auch ausgewählt.

Siehe auch cursorWordBackward().

[slot] void QLineEdit::cut()

Kopiert den markierten Text in die Zwischenablage und löscht ihn, wenn er vorhanden ist und wenn echoMode() Normal ist.

Wenn der aktuelle Validator das Löschen des markierten Textes nicht zulässt, kopiert cut() ohne zu löschen.

Siehe auch copy(), paste(), und setValidator().

void QLineEdit::del()

Wenn kein Text markiert ist, wird das Zeichen rechts vom Textcursor gelöscht. Wenn Text markiert ist, wird der Cursor an den Anfang des markierten Textes gesetzt und der markierte Text gelöscht.

Siehe auch backspace().

void QLineEdit::deselect()

Hebt die Markierung des markierten Textes auf.

Siehe auch setSelection() und selectAll().

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

Reimplements: QWidget::dragEnterEvent(QDragEnterEvent *event).

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

Reimplements: QWidget::dragLeaveEvent(QDragLeaveEvent *event).

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

Reimplements: QWidget::dragMoveEvent(QDragMoveEvent *event).

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

Reimplements: QWidget::dropEvent(QDropEvent *event).

[signal] void QLineEdit::editingFinished()

Dieses Signal wird ausgegeben, wenn die Return- oder Enter-Taste verwendet wird, oder wenn die Eingabezeile den Fokus verliert und ihr Inhalt seit der letzten Ausgabe dieses Signals geändert wurde.

void QLineEdit::end(bool mark)

Bewegt den Textcursor an das Ende der Zeile, sofern er sich nicht bereits dort befindet. Wenn mark wahr ist, wird der Text zur letzten Position hin markiert. Andernfalls wird jeder markierte Text abgewählt, wenn der Cursor verschoben wird.

Siehe auch home().

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

Reimplements: QWidget::event(QEvent *Event).

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

Reimplements: QWidget::focusInEvent(QFocusEvent *event).

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

Reimplements: QWidget::focusOutEvent(QFocusEvent *event).

void QLineEdit::home(bool mark)

Verschiebt den Textcursor an den Anfang der Zeile, sofern er sich nicht bereits dort befindet. Wenn mark wahr ist, wird der Text an der ersten Position markiert. Andernfalls wird jeder markierte Text abgewählt, wenn der Cursor verschoben wird.

Siehe auch end().

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

Initialisieren Sie option mit den Werten aus dieser QLineEdit. Diese Methode ist nützlich für Unterklassen, wenn sie eine QStyleOptionFrame benötigen, aber nicht alle Informationen selbst eingeben wollen.

Siehe auch QStyleOption::initFrom().

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

Reimplements: QWidget::inputMethodEvent(QInputMethodEvent *event).

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

Reimplements: QWidget::inputMethodQuery(Qt::InputMethodQuery query) const.

[signal] void QLineEdit::inputRejected()

Dieses Signal wird ausgegeben, wenn der Benutzer eine Taste verwendet, die nicht als gültige Eingabe betrachtet wird. Zum Beispiel, wenn die Verwendung einer Taste dazu führt, dass der Aufruf validate() eines Validators Invalid zurückgibt. Ein weiterer Fall ist der Versuch, mehr Zeichen als die maximale Länge der Eingabezeile einzugeben.

void QLineEdit::insert(const QString &newText)

Löscht den markierten Text, fügt newText ein und überprüft das Ergebnis. Wenn es gültig ist, wird der neue Text als neuer Inhalt der Bearbeitungszeile festgelegt.

Siehe auch setText() und clear().

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

Reimplements: QWidget::keyPressEvent(QKeyEvent *event).

Konvertiert den angegebenen Tastendruck event in eine Zeilenbearbeitungsaktion.

Wenn Return oder Enter verwendet wird und der aktuelle Text gültig ist (oder vom Validator made valid werden kann), wird das Signal returnPressed() ausgegeben.

Siehe auch Default Key Bindings.

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

Reimplements: QWidget::keyReleaseEvent(QKeyEvent *event).

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

Reimplantiert eine Zugriffsfunktion für die Eigenschaft: QWidget::minimumSizeHint.

Gibt eine Mindestgröße für die Zeilenbearbeitung zurück.

Die zurückgegebene Breite reicht normalerweise für mindestens ein Zeichen aus.

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

Reimplements: QWidget::mouseDoubleClickEvent(QMouseEvent *event).

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

Reimplements: QWidget::mouseMoveEvent(QMouseEvent *event).

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

Reimplements: QWidget::mousePressEvent(QMouseEvent *event).

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

Reimplements: QWidget::mouseReleaseEvent(QMouseEvent *event).

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

Reimplements: QWidget::paintEvent(QPaintEvent *event).

[slot] void QLineEdit::paste()

Fügt den Text aus der Zwischenablage an der Cursorposition ein und löscht den markierten Text, sofern die Zeilenbearbeitung nicht read-only ist.

Wenn das Endergebnis für die aktuelle validator ungültig wäre, geschieht nichts.

Siehe auch copy() und cut().

[slot] void QLineEdit::redo()

Wiederholt den letzten Vorgang, wenn redo available ist.

[signal] void QLineEdit::returnPressed()

Dieses Signal wird ausgegeben, wenn die Return- oder Enter-Taste verwendet wird.

[slot] void QLineEdit::selectAll()

Markiert den gesamten Text (hebt ihn hervor) und bewegt den Cursor an das Ende.

Siehe auch setSelection() und deselect().

[signal] void QLineEdit::selectionChanged()

Dieses Signal wird immer dann ausgegeben, wenn sich die Auswahl ändert.

Siehe auch hasSelectedText() und selectedText().

int QLineEdit::selectionEnd() const

Gibt den Index des Zeichens direkt nach der Auswahl in der Zeilenbearbeitung zurück (oder -1, wenn kein Text ausgewählt ist).

Siehe auch selectedText(), selectionStart(), und selectionLength().

int QLineEdit::selectionLength() const

Gibt die Länge der Auswahl zurück.

Siehe auch selectedText(), selectionStart(), und selectionEnd().

int QLineEdit::selectionStart() const

Gibt den Index des ersten ausgewählten Zeichens in der Zeilenbearbeitung zurück (oder -1, wenn kein Text ausgewählt ist).

Siehe auch selectedText(), selectionEnd(), und selectionLength().

void QLineEdit::setCompleter(QCompleter *c)

Stellt diese Zeilenbearbeitung so ein, dass sie automatische Vervollständigungen durch den Vervollständiger c bietet. Der Vervollständigungsmodus wird mit QCompleter::setCompletionMode() eingestellt.

Um ein QCompleter mit einem QValidator oder QLineEdit::inputMask zu verwenden, müssen Sie sicherstellen, dass das an QCompleter übergebene Modell gültige Einträge enthält. Sie können die QSortFilterProxyModel verwenden, um sicherzustellen, dass das Modell von QCompleter nur gültige Einträge enthält.

Um die Vervollständigung zu entfernen und die automatische Vervollständigung zu deaktivieren, übergeben Sie ein nullptr.

Siehe auch completer() und QCompleter.

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

Wählt Text ab Position start und für length aus. Negative Längen sind erlaubt.

Siehe auch deselect(), selectAll(), und selectedText().

void QLineEdit::setTextMargins(const QMargins &margins)

Legt die margins um den Text innerhalb des Rahmens fest.

Siehe auch textMargins().

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

Legt fest, dass die Ränder um den Text innerhalb des Rahmens die Größen left, top, right und bottom haben sollen.

Siehe auch textMargins().

void QLineEdit::setValidator(const QValidator *v)

Setzt den Validator für die Werte von line edit auf v.

Die Signale returnPressed() und editingFinished() der Zeile edit werden nur ausgegeben, wenn v den Inhalt der Zeile edit als Acceptable validiert. Der Benutzer kann den Inhalt während der Bearbeitung auf einen beliebigen Intermediate Wert ändern, wird aber daran gehindert, den Text auf einen Wert zu ändern, den v als Invalid validiert.

Auf diese Weise können Sie den Text, der nach der Bearbeitung gespeichert wird, einschränken, während Sie dem Benutzer genügend Freiheit lassen, den Text von einem gültigen Zustand in einen anderen zu ändern.

Um den aktuellen Eingabevalidator zu entfernen, geben Sie nullptr ein. In der Grundeinstellung gibt es keine Eingabeüberprüfung (jede Eingabe wird bis zu maxLength() akzeptiert).

Siehe auch validator(), hasAcceptableInput(), QIntValidator, QDoubleValidator, und QRegularExpressionValidator.

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

Reimplantiert eine Zugriffsfunktion für die Eigenschaft: QWidget::sizeHint.

Gibt eine empfohlene Größe für das Widget zurück.

Die zurückgegebene Breite in Pixeln reicht normalerweise für etwa 15 bis 20 Zeichen.

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

Dieses Signal wird ausgegeben, wenn sich der Text ändert. Das Argument text ist der neue Text.

Im Gegensatz zu textEdited() wird dieses Signal auch ausgegeben, wenn der Text programmatisch geändert wird, z. B. durch den Aufruf von setText().

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

Dieses Signal wird ausgegeben, wenn der Text bearbeitet wird. Das Argument text ist der neue Text.

Im Gegensatz zu textChanged() wird dieses Signal nicht ausgegeben, wenn der Text programmatisch geändert wird, z. B. durch den Aufruf von setText().

QMargins QLineEdit::textMargins() const

Gibt die Textränder des Widgets zurück.

Siehe auch setTextMargins().

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

Reimplements: QObject::timerEvent(QTimerEvent *event).

[slot] void QLineEdit::undo()

Macht den letzten Vorgang rückgängig, wenn Rückgängig available ist. Deselektiert die aktuelle Auswahl und aktualisiert den Auswahlanfang auf die aktuelle Cursorposition.

const QValidator *QLineEdit::validator() const

Gibt einen Zeiger auf den aktuellen Eingabevalidator zurück, oder nullptr, wenn kein Validator gesetzt wurde.

Siehe auch setValidator().