InputMethod QML Type (Singleton)

Bietet QML-Anwendungen Zugriff auf „ QInputMethod “. Mehr...

Hinweis: Dieser Typ ist ein QML-Singleton. Es gibt nur eine Instanz dieses Typs in der QML-Engine.

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• anchorRectangle : rect
• animating : bool
• cursorRectangle : rect
• inputDirection : enumeration
• inputItemClipRectangle : rect
• keyboardRectangle : rect
• locale : Locale
• visible : bool

Methoden

• void commit()
• void hide()
• void invokeAction(var a, int cursorPosition)
• void reset()
• void show()
• void update(enumeration queries)

Ausführliche Beschreibung

Das InputMethod-Singleton ermöglicht den Zugriff auf das „ QInputMethod “-Objekt der Anwendung sowie auf alle dessen Eigenschaften und Slots. Weitere Informationen finden Sie in der Dokumentation zu „ QInputMethod “.

Dokumentation zu den Eigenschaften

anchorRectangle : rect

Gibt das Ankerrechteck des Eingabeelements in Fensterkoordinaten an.

Das Ankerrechteck wird häufig von verschiedenen Textbearbeitungselementen wie Popups zur Textvorhersage verwendet, um der Textauswahl zu folgen.

animating : bool

Wahr, wenn die virtuelle Tastatur geöffnet oder geschlossen wird.

Der Wert dieser Eigenschaft ist „false“, wenn die Tastatur vollständig geöffnet oder geschlossen ist. Wenn „ animating “ den Wert „ true “ und „ visibility “ den Wert „ true “ hat, wird die Tastatur gerade geöffnet. Wenn „ animating “ den Wert „ true “ und „ visibility “ den Wert „false“ hat, wird die Tastatur gerade geschlossen.

cursorRectangle : rect

Cursorrechteck des Eingabefelds in Fensterkoordinaten.

Das Cursor-Rechteck wird häufig von verschiedenen Textbearbeitungselementen wie Popups zur Textvorhersage verwendet, um den gerade eingegebenen Text zu verfolgen.

inputDirection : enumeration

Aktuelle Eingaberichtung.

Mögliche Werte:

inputItemClipRectangle : rect

Das beschnittene Rechteck des Eingabeelements in Fensterkoordinaten.

Das beschnittene Eingaberechteck wird häufig von verschiedenen Eingabemethoden verwendet, um zu bestimmen, wie viel Platz auf dem Bildschirm für die Eingabemethode (z. B. die virtuelle Tastatur) zur Verfügung steht.

keyboardRectangle : rect

Geometrie der virtuellen Tastatur in Fensterkoordinaten.

Dies kann ein leeres Rechteck sein, wenn die Geometrie der Tastatur nicht bekannt ist. Dies ist beispielsweise bei einer schwebenden Tastatur unter Android der Fall.

locale : Locale

Aktuelle Eingabesprachumgebung.

visible : bool

Sichtbarkeit der virtuellen Tastatur auf dem Bildschirm

Der Wert dieser Eigenschaft bleibt bei Geräten ohne virtuelle Tastatur auf „false“ gesetzt.

Siehe auch „ show()“ und „ hide()“.

Methodendokumentation

void commit()

Überträgt das Wort, das der Benutzer gerade verfasst, in den Editor. Die Funktion wird vor allem von Eingabemethoden mit Textvorhersagefunktionen benötigt sowie von Methoden, 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 Eingabestatus durch Aufruf der Funktion `commit()` zurücksetzen, beispielsweise wenn der Cursor an eine andere Stelle bewegt wird.

void hide()

Fordert das Schließen der virtuellen Tastatur an.

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

void invokeAction(var a, int cursorPosition)

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

Siehe auch „ QInputMethod::Action “.

void 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 fokussierte Editor ändert.

void 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, da sich die Tastatur automatisch öffnen sollte, sobald der Texteditor den Fokus erhält.

void update(enumeration queries)

Wird vom Eingabeelement aufgerufen, um die Eingabemethoden der Plattform darüber zu informieren, wenn sich der Status der Abfrageattribute der Eingabemethode im Editor geändert hat. Beim Aufruf der Funktion muss der Parameter „ queries “ verwendet werden, um anzugeben, was sich geändert hat. Eine Eingabemethode kann dies nutzen, um mit „ QInputMethodQueryEvent “ Abfragen zu den Attributen durchzufü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 ` Qt::ImQueryInput ` zusammengefasst.

Siehe auch „ Qt::InputMethodQueries “.