InputMethod QML Type

Basistyp für die Erstellung von Eingabemethoden in QML. Mehr...

Import Statement: import QtQuick.VirtualKeyboard

Eigenschaften

Signale

Methoden

Detaillierte Beschreibung

Mit dem Typ InputMethod können Sie eine benutzerdefinierte Eingabemethode erstellen, die InputEngine zugewiesen werden kann.

Eigenschaft Dokumentation

inputContext : InputContext [read-only]

Der Eingabekontext.


inputEngine : InputEngine [read-only]

Die Eingabe-Engine.


Signal Dokumentation

selectionListActiveItemChanged(int type, int index)

Die Eingabemethode gibt dieses Signal aus, wenn sich der aktuelle index in der durch type identifizierten Auswahlliste geändert hat.

Hinweis: Der entsprechende Handler ist onSelectionListActiveItemChanged.


selectionListChanged(int type)

Die Eingabemethode gibt dieses Signal aus, wenn der Inhalt der Auswahlliste geändert wird. Der Parameter type gibt an, welche Auswahlliste sich geändert hat.

Hinweis: Der entsprechende Handler ist onSelectionListChanged.


[since QtQuick.VirtualKeyboard 2.2] selectionListsChanged()

Die Eingabemethode gibt dieses Signal aus, wenn sich die Typen der Auswahlliste geändert haben. Dieses Signal löst einen Aufruf der Methode selectionLists() aus, so dass die Eingabemethode die Auswahllistentypen aktualisieren kann.

Hinweis: Der entsprechende Handler ist onSelectionListsChanged.

Dieses Signal wurde in QtQuick.VirtualKeyboard 2.2 eingeführt.


Dokumentation der Methode

[since QtQuick.VirtualKeyboard 2.4] bool clickPreeditText(int cursorPosition)

Wird aufgerufen, wenn der Benutzer auf den Text vor der Bearbeitung unter cursorPosition klickt.

Die Funktion sollte true zurückgeben, wenn sie das Ereignis verarbeitet. Andernfalls fällt die Eingabe zurück zu reselect() zur weiteren Verarbeitung.

Diese Methode wurde in QtQuick.VirtualKeyboard 2.4 eingeführt.


list<int> inputModes(string locale)

Gibt eine Liste von Eingabemodi für locale zurück.


bool keyEvent(int key, string text, int modifiers)

Der Zweck dieser Methode ist es, die von der Eingabe-Engine erzeugten Tastenereignisse zu verarbeiten.

Der Parameter key gibt den Code der zu behandelnden Taste an. Der Tastencode unterscheidet nicht zwischen Groß- und Kleinbuchstaben. Der Parameter text enthält den Unicode-Text für den Schlüssel. Der Parameter modifiers enthält die Schlüsselmodifikatoren, die für key gelten.

Diese Methode gibt true zurück, wenn das Schlüsselereignis erfolgreich behandelt wurde. Wenn der Rückgabewert false lautet, wird das Schlüsselereignis zur weiteren Verarbeitung an die Standardeingabemethode weitergeleitet.


[since QtQuick.VirtualKeyboard 2.0] list<int> patternRecognitionModes()

Gibt die Liste der unterstützten Mustererkennungsmodi zurück.

Diese Methode wird von der Eingabe-Engine aufgerufen, um die Liste der unterstützten Mustererkennungsmodi abzufragen.

Diese Methode wurde in QtQuick.VirtualKeyboard 2.0 eingeführt.


[since QtQuick.VirtualKeyboard 2.0] bool reselect(int cursorPosition, int reselectFlags)

Mit dieser Methode wird versucht, ein Wort, das sich auf cursorPosition befindet, erneut auszuwählen. reselectFlags definiert die Regeln, nach denen das Wort im Verhältnis zur Cursorposition ausgewählt werden soll.

  • InputEngine.WordBeforeCursor Aktivieren Sie das Wort vor dem Cursor. Wenn ausschließlich dieses Flag verwendet wird, muss das Wort genau am Cursor enden.
  • InputEngine.WordAfterCursor Aktiviere das Wort nach dem Cursor. Wenn ausschließlich dieses Flag verwendet wird, muss das Wort genau am Cursor beginnen.
  • InputEngine.WordAtCursor Aktiviere das Wort an der Schreibmarke. Dieses Flag ist eine Kombination der oben genannten Flags, mit der Ausnahme, dass das Wort nicht am Cursor beginnen oder enden darf.

Die Methode gibt true zurück, wenn das Wort erfolgreich neu ausgewählt wurde.

Diese Methode wurde in QtQuick.VirtualKeyboard 2.0 eingeführt.


reset()

Diese Methode wird von der Eingabe-Engine aufgerufen, wenn diese Eingabemethode zurückgesetzt werden muss. Die Eingabemethode muss nur ihren internen Zustand zurücksetzen. Der Hauptunterschied zur Methode update() besteht darin, dass reset() nur den Zustand der Eingabemethode ändert; der Eingabekontext darf nicht verändert werden.


var selectionListData(int type, int index, int role)

Gibt Elementdaten für eine durch type identifizierte Auswahlliste zurück. Der Parameter role gibt an, welche Daten angefordert werden. Der Parameter index ist ein auf Null basierender Index in der Auswahlliste.


int selectionListItemCount(int type)

Gibt die Anzahl der Elemente in der durch type identifizierten Auswahlliste zurück.


void selectionListItemSelected(int type, int index)

Diese Methode wird aufgerufen, wenn ein Eintrag unter index vom Benutzer ausgewählt wurde. Die Auswahlliste wird durch den Parameter type identifiziert.


list<int> selectionLists()

Gibt die Liste der für diese Eingabemethode verwendeten Auswahltypen zurück.

Diese Methode wird von der Eingabemaschine aufgerufen, wenn die Eingabemethode aktiviert wird und jedes Mal, wenn die Hinweise zur Eingabemethode aktualisiert werden. Die Eingabemethode kann Auswahllisten reservieren, indem sie die gewünschten Auswahllistentypen zurückgibt.

Die Eingabemethode kann die Eingabemaschine jederzeit auffordern, die Auswahllisten zu aktualisieren, indem sie das Signal selectionListsChanged() ausgibt. Dieses Signal löst einen Aufruf dieser Methode aus, so dass die Eingabemethode die Auswahllistentypen aktualisieren kann.


bool setInputMode(string locale, int inputMode)

Ändert inputMode und locale für diese Eingabemethode. Die Methode gibt bei Erfolg true zurück.


bool setTextCase(int textCase)

Aktualisiert textCase für diese Eingabemethode. Die Methode gibt im Erfolgsfall true zurück.

Die möglichen Werte für die Textgröße sind:

  • InputEngine.Lower Text in Kleinbuchstaben.
  • InputEngine.Upper Text in Großbuchstaben.

[since QtQuick.VirtualKeyboard 2.0] Trace traceBegin(int traceId, int patternRecognitionMode, var traceCaptureDeviceInfo, var traceScreenInfo)

Diese Methode wird aufgerufen, wenn eine Trace-Interaktion mit dem angegebenen patternRecognitionMode beginnt. Der Trace wird eindeutig durch traceId identifiziert. traceCaptureDeviceInfo liefert Informationen über das Quellgerät und traceScreenInfo liefert Informationen über den Bildschirmkontext.

Wenn die Eingabemethode das Ereignis annimmt und die Trace-Eingabe erfassen will, muss sie ein neues Trace-Objekt zurückgeben. Dieses Objekt muss gültig bleiben, bis die Methode InputMethod.traceEnd() aufgerufen wird. Wenn der Trace auf dem Bildschirm gerendert wird, bleibt er dort, bis das Trace-Objekt zerstört wird.

Diese Methode wurde in QtQuick.VirtualKeyboard 2.0 eingeführt.


[since QtQuick.VirtualKeyboard 2.0] bool traceEnd(Trace trace)

Diese Methode wird aufgerufen, wenn die Trace-Interaktion beendet ist. Die Eingabemethode sollte das Objekt trace irgendwann nach dem Aufruf dieser Funktion zerstören. Gibt bei Erfolg true zurück.

Siehe die Trace API für Eingabemethoden, wie man auf die gesammelten Daten zugreift.

Diese Methode wurde in QtQuick.VirtualKeyboard 2.0 eingeführt.


update()

Diese Methode wird von der Eingabe-Engine aufgerufen, wenn die Eingabemethode aktualisiert werden muss. Die Eingabemethode muss den aktuellen Text vor dem Editieren schließen und den internen Zustand auf den Standard zurücksetzen.


© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.