InputMethod QML Type
Basistyp für die Erstellung von Eingabemethoden in QML. Mehr...
Import Statement: | import QtQuick.VirtualKeyboard |
Eigenschaften
- inputContext : InputContext
- inputEngine : InputEngine
Signale
- selectionListActiveItemChanged(int type, int index)
- selectionListChanged(int type)
- selectionListsChanged()
(since QtQuick.VirtualKeyboard 2.2)
Methoden
- bool clickPreeditText(int cursorPosition)
(since QtQuick.VirtualKeyboard 2.4)
- list<int> inputModes(string locale)
- bool keyEvent(int key, string text, int modifiers)
- list<int> patternRecognitionModes()
(since QtQuick.VirtualKeyboard 2.0)
- bool reselect(int cursorPosition, int reselectFlags)
(since QtQuick.VirtualKeyboard 2.0)
- reset()
- var selectionListData(int type, int index, int role)
- int selectionListItemCount(int type)
- void selectionListItemSelected(int type, int index)
- list<int> selectionLists()
- bool setInputMode(string locale, int inputMode)
- bool setTextCase(int textCase)
- Trace traceBegin(int traceId, int patternRecognitionMode, var traceCaptureDeviceInfo, var traceScreenInfo)
(since QtQuick.VirtualKeyboard 2.0)
- bool traceEnd(Trace trace)
(since QtQuick.VirtualKeyboard 2.0)
- update()
Detaillierte Beschreibung
Mit dem Typ InputMethod können Sie eine benutzerdefinierte Eingabemethode erstellen, die InputEngine zugewiesen werden kann.
Eigenschaft Dokumentation
inputContext : InputContext |
Der Eingabekontext.
inputEngine : InputEngine |
Die Eingabe-Engine.
Signal Dokumentation
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
.
|
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
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.
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.
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.
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.
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.
Gibt die Anzahl der Elemente in der durch type identifizierten Auswahlliste zurück.
Diese Methode wird aufgerufen, wenn ein Eintrag unter index vom Benutzer ausgewählt wurde. Die Auswahlliste wird durch den Parameter type identifiziert.
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.
Ändert inputMode und locale für diese Eingabemethode. Die Methode gibt bei Erfolg true
zurück.
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.
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.
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.