QInputMethod Class

Dokumentation der Mitgliedsfunktionen

[slot] void QInputMethod::commit()

Überträgt das Wort, das der Benutzer gerade verfasst, in den Editor. Die Funktion wird vor allem von Eingabemethoden mit Textvorhersagefunktionen sowie von Methoden benötigt, bei denen sich das zur Eingabe von Zeichen verwendete Skript von dem Skript unterscheidet, das tatsächlich an den Editor angehängt wird. Jede Aktion, die die Texteingabe unterbricht, muss den Eingabezustand durch Aufruf der Funktion `commit()` zurücksetzen, beispielsweise wenn der Cursor an eine andere Stelle bewegt wird.

[slot] void QInputMethod::hide()

Fordert das Schließen der virtuellen Tastatur an.

Normalerweise sollten Anwendungen diese Funktion nicht aufrufen müssen; die Tastatur sollte sich automatisch schließen, wenn der Texteditor den Fokus verliert, beispielsweise wenn die übergeordnete Ansicht geschlossen wird.

QRectF QInputMethod::inputItemRectangle() const

Gibt die Geometrie des Eingabeelements in den Koordinaten des Eingabeelements zurück.

Siehe auch „ setInputItemRectangle()“.

QTransform QInputMethod::inputItemTransform() const

Gibt die Transformation von den Koordinaten der Eingabeelemente in die Fensterkoordinaten zurück.

Siehe auch „ setInputItemTransform()“.

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

Wird vom Eingabeelement aufgerufen, wenn der Benutzer auf das gerade eingegebene Wort tippt, wie durch die Aktion „ a “ und die angegebene „ cursorPosition “ angegeben. Eingabemethoden nutzen diese Informationen häufig, um dem Benutzer weitere Wortvorschläge anzubieten.

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

Rufe die Funktion „ query “ für das aktuell fokussierte Objekt mit den Parametern „ argument “ auf und gib das Ergebnis zurück.

[slot] void QInputMethod::reset()

Setzt den Status der Eingabemethode zurück. Beispielsweise ruft ein Texteditor diese Methode normalerweise vor dem Einfügen von Text auf, um das Widget für die Texteingabe vorzubereiten.

Die Eingabemethode wird automatisch zurückgesetzt, wenn sich der Editor mit Fokus ändert.

void QInputMethod::setInputItemRectangle(const QRectF &rect)

Legt die Geometrie des Eingabeelements auf ` rect` fest, bezogen auf die Koordinaten des Eingabeelements. Dies muss vom Fenster mit Fokus – beispielsweise von QQuickCanvas – aktualisiert werden, sobald das Element innerhalb der Szene verschoben wird oder der Fokus wechselt.

Siehe auch ` inputItemRectangle()`.

void QInputMethod::setInputItemTransform(const QTransform &transform)

Legt die Transformation von den Koordinaten der Eingabeelemente in Fensterkoordinaten fest auf transform. Die Elementtransformation muss vom aktiven Fenster – beispielsweise QQuickCanvas – aktualisiert werden, sobald ein Element innerhalb der Szene verschoben wird.

Siehe auch ` inputItemTransform()`.

void QInputMethod::setVisible(bool visible)

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

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

[slot] void QInputMethod::show()

Fordert das Öffnen der virtuellen Tastatur an. Wenn die Plattform keine virtuelle Tastatur bereitstellt, bleibt die Sichtbarkeit auf „false“ gesetzt.

Normalerweise sollten Anwendungen diese Funktion nicht aufrufen müssen; die Tastatur sollte sich automatisch öffnen, sobald der Texteditor den Fokus erhält.

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

Wird vom Eingabeelement aufgerufen, um die Eingabemethoden der Plattform darüber zu informieren, wenn sich der Status der Abfrageattribute der Eingabemethode des Editors geändert hat. Beim Aufruf der Funktion muss der Parameter „ queries “ verwendet werden, um anzugeben, was sich geändert hat; die Eingabemethode kann damit über „ QInputMethodQueryEvent “ Abfragen zu den Attributen durchführen, die für sie von Interesse sind.

Insbesondere ist es wichtig, „update“ immer dann aufzurufen, wenn sich die Cursorposition ändert, da dies häufig dazu führt, dass sich auch andere Abfrageattribute wie der umgebende Text und die Textauswahl ändern. Die Attribute, die sich häufig zusammen mit der Cursorposition ändern, wurden der Einfachheit halber im Wert von „ Qt::ImQueryInput “ zusammengefasst.