QLineEdit Class

Dokumentation zu den Member-Funktionen

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

Erstellt ein Textfeld ohne Text.

Die maximale Textlänge ist auf 32767 Zeichen festgelegt.

Das Argument „ parent “ wird an den Konstruktor „ QWidget “ übergeben.

Siehe auch „ setText()“ und „ setMaxLength()“.

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

Erstellt ein Zeilenbearbeitungsfeld mit dem Text „ contents “ als untergeordnetes Element von „ parent “.

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

Siehe auch „ text()“ und „ setMaxLength()“.

[virtual noexcept] QLineEdit::~QLineEdit()

Löscht die Zeile „edit“.

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

Fügt die „ action “ zur Liste der Aktionen unter position hinzu.

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

Erstellt eine neue Aktion mit dem angegebenen „ icon “ unter „ 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 verschoben und der markierte Text gelöscht.

Siehe auch ` del()`.

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

Umsetzt: QWidget::changeEvent(QEvent *event).

[slot] void QLineEdit::clear()

Löscht den Inhalt des Eingabefelds.

Siehe auch setText() und insert().

QCompleter *QLineEdit::completer() const

Gibt das aktuelle „ QCompleter “ zurück, das Vervollständigungsvorschläge bereitstellt.

Siehe auch setCompleter().

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

Implementiert: ` QWidget::contextMenuEvent(QContextMenuEvent *event)`.

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

Wenn Sie nicht möchten, dass das Zeileneingabefeld über ein Kontextmenü verfügt, können Sie dessen ` 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 Sie ` createStandardContextMenu()` auf und erweitern Sie 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 zum Zeitpunkt der Ereignisauslösung befand.

Siehe auch ` setContextMenuPolicy()`.

[slot] void QLineEdit::copy() const

Kopiert den ausgewählten Text in die Zwischenablage, sofern vorhanden und sofern echoMode() den Wert „ Normal “ hat.

Siehe auch cut() und paste().

QMenu *QLineEdit::createStandardContextMenu()

Erstellt das Standardkontextmenü, das angezeigt wird, wenn der Benutzer mit der rechten Maustaste auf das Eingabefeld klickt. Es wird vom Standard-Handler „ contextMenuEvent()“ aufgerufen. Die Eigentumsrechte am Popup-Menü werden an den Aufrufer übertragen.

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

Bewegt den Cursor um steps Zeichen zurück. Ist mark wahr, wird jedes überfahrene Zeichen der Auswahl hinzugefügt. Ist mark falsch, wird die Auswahl gelöscht.

Siehe auch cursorForward().

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

Bewegt den Cursor um steps Zeichen nach vorne. Wenn mark wahr ist, wird jedes überflogene Zeichen 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 ausgelöst, 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 Cursor des Zeileneingabefelds enthält.

void QLineEdit::cursorWordBackward(bool mark)

Bewegt den Cursor um ein Wort zurück. Wenn „ mark “ auf „true“ gesetzt ist, wird das Wort zusätzlich markiert.

Siehe auch ` cursorWordForward()`.

void QLineEdit::cursorWordForward(bool mark)

Bewegt den Cursor um ein Wort nach vorne. Wenn „ mark “ auf „true“ gesetzt ist, wird das Wort zusätzlich markiert.

Siehe auch cursorWordBackward().

[slot] void QLineEdit::cut()

Kopiert den ausgewählten Text in die Zwischenablage und löscht ihn, sofern vorhanden, und sofern ` echoMode()` den Wert ` Normal` zurückgibt.

Wenn der aktuelle Validator das Löschen des ausgewählten Textes nicht zulässt, kopiert `cut()` den Text, ohne ihn 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 Auswahl des markierten Textes auf.

Siehe auch setSelection() und selectAll().

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

Umsetzt: ` QWidget::dragEnterEvent` (`QDragEnterEvent *event`).

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

Implementiert: ` QWidget::dragLeaveEvent` (`QDragLeaveEvent *event`).

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

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

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

Implementiert: ` QWidget::dropEvent(QDropEvent *event)`.

[signal] void QLineEdit::editingFinished()

Dieses Signal wird ausgelöst, wenn die Return- oder Enter-Taste gedrückt wird oder wenn das Eingabefeld den Fokus verliert und sich sein Inhalt seit der letzten Auslösung dieses Signals geändert hat.

void QLineEdit::end(bool mark)

Bewegt den Textcursor an das Zeilenende, sofern er sich nicht bereits dort befindet. Ist „ mark “ auf „true“ gesetzt, wird der Text bis zur letzten Position markiert. Andernfalls wird der markierte Text beim Verschieben des Cursors die Markierung aufheben.

Siehe auch home().

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

Umsetzt: ` QWidget::event(QEvent *event)`.

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

Implementiert: ` QWidget::focusInEvent` (`QFocusEvent *event`).

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

Implementiert: ` QWidget::focusOutEvent(QFocusEvent *event)`.

void QLineEdit::home(bool mark)

Bewegt den Textcursor an den Zeilenanfang, sofern er sich nicht bereits dort befindet. Ist „ mark “ auf „true“ gesetzt, wird der Text bis zur ersten Position markiert. Andernfalls wird der markierte Text beim Verschieben des Cursors die Markierung aufheben.

Siehe auch ` end()`.

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

Initialisieren Sie ` option ` mit den Werten aus dieser Datei: QLineEdit. Diese Methode ist für Unterklassen nützlich, wenn diese ein ` QStyleOptionFrame` benötigen, aber nicht alle Informationen selbst eingeben möchten.

Siehe auch QStyleOption::initFrom().

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

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

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

Implementiert neu: ` QWidget::inputMethodQuery` (Qt::InputMethodQuery query) const.

[signal] void QLineEdit::inputRejected()

Dieses Signal wird ausgelöst, wenn der Benutzer eine Taste drückt, die nicht als gültige Eingabe angesehen wird. Dies ist beispielsweise der Fall, wenn die Betätigung einer Taste dazu führt, dass der Aufruf von ` validate()` des Validators den Wert ` Invalid` zurückgibt. Ein weiterer Fall tritt auf, wenn versucht wird, mehr Zeichen einzugeben, als die maximale Länge des Zeileneingabefelds zulässt.

void QLineEdit::insert(const QString &newText)

Löscht den ausgewählten Text, fügt „ newText “ ein und überprüft die Gültigkeit des Ergebnisses. Ist das Ergebnis gültig, wird der neue Text als neuer Inhalt des Zeilenedits gesetzt.

Siehe auch „ setText()“ und „ clear()“.

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

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

Wandelt den angegebenen Tastendruck event in eine Aktion für das Zeileneingabefeld um.

Wenn die Return- oder Enter-Taste gedrückt wird und der aktuelle Text gültig ist (oder vom Validator als gültig made valid werden kann), wird das Signal „ returnPressed()“ ausgelöst.

Siehe auch „ Default Key Bindings “.

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

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

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

Implementiert eine Zugriffsfunktion für die Eigenschaft „ QWidget::minimumSizeHint “ neu.

Gibt die Mindestgröße für das Zeilenbearbeitungsfeld zurück.

Die zurückgegebene Breite reicht in der Regel für mindestens ein Zeichen aus.

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

Implementiert: ` QWidget::mouseDoubleClickEvent(QMouseEvent *event)`.

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

Implementiert: ` QWidget::mouseMoveEvent` (`QMouseEvent *event`).

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

Implementiert: ` QWidget::mousePressEvent(QMouseEvent *event)`.

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

Implementiert: ` QWidget::mouseReleaseEvent(QMouseEvent *event)`.

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

Umsetzt: ` QWidget::paintEvent` (`QPaintEvent *event`).

[slot] void QLineEdit::paste()

Fügt den Text aus der Zwischenablage an der Cursorposition ein und löscht dabei eventuell markierten Text, sofern das Zeilenfeld nicht auf „ read-only “ gesetzt ist.

Sollte das Endergebnis für die aktuelle „ validator “ ungültig sein, geschieht nichts.

Siehe auch „ copy()“ und „ cut()“.

[slot] void QLineEdit::redo()

Führt die letzte Operation erneut aus, wenn „redo“ auf „ available “ gesetzt ist.

[signal] void QLineEdit::returnPressed()

Dieses Signal wird ausgelöst, wenn die Return- oder Enter-Taste gedrückt 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 ausgesendet, wenn sich die Auswahl ändert.

Siehe auch hasSelectedText() und selectedText().

int QLineEdit::selectionEnd() const

Gibt den Index des Zeichens unmittelbar nach der Auswahl im Zeileneingabefeld 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 im Zeilenbearbeitungsfeld zurück (oder -1, wenn kein Text ausgewählt ist).

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

void QLineEdit::setCompleter(QCompleter *c)

Legt fest, dass dieses Eingabefeld Autovervollständigungen aus dem Vervollständigungstool „ c “ bereitstellt. Der Vervollständigungsmodus wird mit der Funktion „ QCompleter::setCompletionMode()“ festgelegt.

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. Mit dem „ QSortFilterProxyModel “ können Sie sicherstellen, dass das Modell von „ QCompleter “ nur gültige Einträge enthält.

Um den Completer zu entfernen und die Autovervollständigung zu deaktivieren, übergeben Sie einen „ nullptr “.

Siehe auch completer() und QCompleter.

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

Wählt Text ab der Position start und über eine Länge von length Zeichen aus. Negative Längen sind zulässig.

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

void QLineEdit::setTextMargins(const QMargins &margins)

Legt die „ margins “ für den Text innerhalb des Rahmens fest.

Siehe auch textMargins().

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

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

Siehe auch textMargins().

void QLineEdit::setValidator(const QValidator *v)

Legt den Validator für die Werte des Zeilen-Editfelds auf „ v “ fest.

Die Signale „ returnPressed()“ und „ editingFinished()“ des Eingabefelds werden nur ausgegeben, wenn „ v “ den Inhalt des Eingabefelds als „ Acceptable “ validiert. Der Benutzer kann den Inhalt während der Bearbeitung auf einen beliebigen Wert unter „ Intermediate “ ändern, wird jedoch daran gehindert, den Text auf einen Wert zu bearbeiten, den „ v “ als „ Invalid “ validiert.

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

Um den aktuellen Eingabevalidator zu entfernen, übergeben Sie „ nullptr “. Die Standardeinstellung sieht keinen Eingabevalidator vor (jede Eingabe wird akzeptiert, sofern sie den Anforderungen von „ maxLength()“ entspricht).

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

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

Implementiert eine Zugriffsfunktion für die Eigenschaft „ QWidget::sizeHint “ neu.

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

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

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

Dieses Signal wird immer dann ausgelöst, wenn sich der Text ändert. Das Argument „ text “ ist der neue Text.

Im Gegensatz zu ` textEdited()` wird dieses Signal auch ausgelöst, wenn der Text programmgesteuert geändert wird, beispielsweise durch den Aufruf von ` setText()`.

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

Dieses Signal wird immer dann ausgelöst, wenn der Text bearbeitet wird. Das Argument „ text “ ist der neue Text.

Im Gegensatz zu ` textChanged()` wird dieses Signal nicht ausgelöst, wenn der Text programmgesteuert geändert wird, beispielsweise 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)

Implementiert: ` QObject::timerEvent` (`QTimerEvent *event`).

[slot] void QLineEdit::undo()

Macht den letzten Vorgang rückgängig, sofern „undo“ auf „ available “ gesetzt ist. Hebt die aktuelle Auswahl auf und setzt den Auswahlstart auf die aktuelle Cursorposition.

const QValidator *QLineEdit::validator() const

Gibt einen Zeiger auf den aktuellen Eingabevalidator zurück oder „ nullptr “, falls kein Validator festgelegt wurde.

Siehe auch setValidator().