QInputMethod Class

Dokumentation der Mitgliedsfunktionen

[slot] void QInputMethod::commit()

Überträgt das Wort, das der Benutzer gerade schreibt, in den Editor. Die Funktion wird vor allem von Eingabemethoden mit Textvorhersagefunktionen benötigt und von Methoden, bei denen das Skript, das für die Eingabe von Zeichen verwendet wird, sich von dem Skript unterscheidet, das tatsächlich an den Editor angehängt wird. Jede Aktion, die das Verfassen des Textes unterbricht, muss den Zustand des Verfassens durch den Aufruf der Funktion commit() löschen, z. B. wenn der Cursor an eine andere Stelle bewegt wird.

[slot] void QInputMethod::hide()

Fordert die virtuelle Tastatur zum Schließen auf.

Normalerweise sollten Anwendungen diese Funktion nicht aufrufen müssen. Die Tastatur sollte automatisch geschlossen werden, wenn der Texteditor den Fokus verliert, z. B. wenn die übergeordnete Ansicht geschlossen wird.

QRectF QInputMethod::inputItemRectangle() const

Gibt die Geometrie des Eingabeelements in Eingabeelementkoordinaten zurück.

Siehe auch setInputItemRectangle().

QTransform QInputMethod::inputItemTransform() const

Gibt die Transformation von den Koordinaten des eingegebenen Elements zu den Fensterkoordinaten zurück.

Siehe auch setInputItemTransform().

[slot] void QInputMethod::invokeAction(QInputMethod::Action a, int cursorPosition)

Wird vom Eingabeelement aufgerufen, wenn der Benutzer auf das Wort tippt, das gerade zusammengesetzt wird, wie aus der Aktion a und der angegebenen cursorPosition hervorgeht. Eingabemethoden nutzen diese Information häufig, um dem Benutzer weitere Wortvorschläge zu unterbreiten.

[static] QVariant QInputMethod::queryFocusObject(Qt::InputMethodQuery query, const QVariant &argument)

Senden Sie query an das aktuelle Fokusobjekt mit den Parametern argument und geben Sie das Ergebnis zurück.

[slot] void QInputMethod::reset()

Setzt den Zustand der Eingabemethode zurück. Zum Beispiel ruft ein Texteditor diese Methode normalerweise auf, bevor er einen Text einfügt, um das Widget bereit zu machen, einen Text zu akzeptieren.

Die Eingabemethode wird automatisch zurückgesetzt, wenn der fokussierte Editor wechselt.

void QInputMethod::setInputItemRectangle(const QRectF &rect)

Setzt die Geometrie des Eingabeelements auf rect, in Koordinaten des Eingabeelements. Dies muss vom fokussierten Fenster wie QQuickCanvas aktualisiert werden, wenn das Element innerhalb der Szene bewegt oder der Fokus geändert wird.

Siehe auch inputItemRectangle().

void QInputMethod::setInputItemTransform(const QTransform &transform)

Setzt die Transformation von den Koordinaten des eingegebenen Elements zu den Fensterkoordinaten auf transform. Die Elementtransformation muss durch das fokussierte Fenster wie QQuickCanvas aktualisiert werden, wenn das Element innerhalb der Szene bewegt wird.

Siehe auch inputItemTransform().

void QInputMethod::setVisible(bool visible)

Steuert die Sichtbarkeit der Tastatur. Entspricht dem Aufruf von show() (wenn visible gleich true ist) oder hide() (wenn visible gleich false ist).

Siehe auch isVisible(), show(), und hide().

[slot] void QInputMethod::show()

Fordert eine virtuelle Tastatur zum Öffnen an. Wenn die Plattform keine virtuelle Tastatur zur Verfügung stellt, bleibt die Sichtbarkeit false.

Normalerweise sollten Anwendungen diese Funktion nicht aufrufen müssen, da die Tastatur automatisch geöffnet wird, wenn der Texteditor den Fokus erhält.

[slot] void QInputMethod::update(Qt::InputMethodQueries queries)

Wird vom Eingabeelement aufgerufen, um die Eingabemethoden der Plattform zu informieren, wenn es Zustandsänderungen in den Abfrageattributen der Eingabemethoden des Editors gegeben hat. Beim Aufruf der Funktion muss der Parameter queries verwendet werden, um mitzuteilen, was sich geändert hat, was die Eingabemethode verwenden kann, um Abfragen für Attribute zu machen, die sie mit QInputMethodQueryEvent interessiert.

Insbesondere der Aufruf von update, wenn sich die Cursorposition ändert, ist wichtig, da sich dadurch oft auch andere Abfrageattribute wie umliegender Text und Textauswahl ändern. Die Attribute, die sich häufig zusammen mit der Cursorposition ändern, wurden der Einfachheit halber in Qt::ImQueryInput value gruppiert.