InputMethod QML Type

Basistyp zum Erstellen einer Eingabemethode in QML. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

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)
• void 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)
• void update()

Ausführliche Beschreibung

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

Dokumentation zu den Eigenschaften

inputContext : InputContext [read-only]

Der Eingabekontext.

inputEngine : InputEngine [read-only]

Die Eingabe-Engine.

Signal-Dokumentation

selectionListActiveItemChanged(int type, int index)

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

selectionListChanged(int type)

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

[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, wodurch die Eingabemethode die Typen der Auswahlliste aktualisieren kann.

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

Methodendokumentation

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

Wird aufgerufen, wenn der Benutzer auf den Vorbearbeitungstext unter cursorPosition klickt.

Die Funktion sollte ` true ` zurückgeben, wenn sie das Ereignis verarbeitet. Andernfalls wird die Eingabe zur weiteren Verarbeitung an ` reselect()` weitergeleitet.

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

list<int> inputModes(string locale)

Gibt eine Liste der Eingabemodi für „ locale “ zurück.

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

Der Zweck dieser Methode besteht darin, die von der Eingabe-Engine generierten Tastenereignisse zu verarbeiten.

Der Parameter „ key “ gibt den Code der zu verarbeitenden Taste an. Bei dem Tastencode wird nicht zwischen Groß- und Kleinbuchstaben unterschieden. Der Parameter „ text “ enthält den Unicode-Text für die Taste. Der Parameter „ modifiers “ enthält die Tastenmodifikatoren, die für „ key “ gelten.

Diese Methode gibt „ true “ zurück, wenn das Tastenereignis erfolgreich verarbeitet wurde. Ist der Rückgabewert „ false “, wird das Tastenereignis zur weiteren Verarbeitung an die Standard-Eingabemethode weitergeleitet.

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

Gibt eine 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)

Diese Methode versucht, ein Wort an der Position „ cursorPosition “ erneut auszuwählen. Die „ reselectFlags “ legen fest, wie das Wort in Bezug auf die Cursorposition ausgewählt werden soll.

• InputEngine.WordBeforeCursor Das Wort vor dem Cursor aktivieren. Wenn dieses Flag ausschließlich verwendet wird, muss das Wort genau am Cursor enden.
• InputEngine.WordAfterCursor Das Wort hinter dem Cursor aktivieren. Wird dieses Flag allein verwendet, muss das Wort genau am Cursor beginnen.
• InputEngine.WordAtCursor Das Wort am Cursor aktivieren. 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 erneut ausgewählt wurde.

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

void reset()

Diese Methode wird von der Eingabe-Engine aufgerufen, wenn diese Eingabemethode zurückgesetzt werden muss. Die Eingabemethode darf dabei ausschließlich ihren internen Zustand zurücksetzen. Der wesentliche Unterschied zur Methode „ update()“ besteht darin, dass „reset()“ lediglich den Zustand der Eingabemethode ändert; der Eingabekontext darf dabei nicht verändert werden.

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

Gibt die Artikeldaten für eine Auswahlliste zurück, die durch ` type` identifiziert wird. Der Parameter ` role ` gibt an, welche Daten angefordert werden. Der Parameter ` index ` ist ein nullbasierter Index innerhalb der Auswahlliste.

int selectionListItemCount(int type)

Gibt die Anzahl der Elemente in der Auswahlliste zurück, die durch ` type` identifiziert wird.

void selectionListItemSelected(int type, int index)

Diese Methode wird aufgerufen, wenn der Benutzer einen Eintrag unter „ index “ ausgewählt hat. 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 Eingabe-Engine aufgerufen, wenn die Eingabemethode aktiviert wird und jedes Mal, wenn die Eingabemethode-Hinweise aktualisiert werden. Die Eingabemethode kann Auswahllisten reservieren, indem sie die gewünschten Auswahllistentypen zurückgibt.

Die Eingabemethode kann die Eingabe-Engine jederzeit auffordern, die Auswahllisten zu aktualisieren, indem sie das Signal „ selectionListsChanged()“ aussendet. Dieses Signal löst einen Aufruf dieser Methode aus, wodurch 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 bei Erfolg „ true “ zurück.

Die möglichen Werte für die Groß-/Kleinschreibung des Textes 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 durch den ` traceId` eindeutig identifiziert. Der ` traceCaptureDeviceInfo ` liefert Informationen zum Quellgerät, und der ` traceScreenInfo ` liefert Informationen zum Bildschirmkontext.

Wenn die Eingabemethode das Ereignis akzeptiert und die Trace-Eingabe erfassen möchte, 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 dargestellt 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 endet. Die Eingabemethode sollte das Objekt „ trace “ zu einem Zeitpunkt nach dem Aufruf dieser Funktion löschen. Gibt bei Erfolg „ true “ zurück.

Informationen zum Zugriff auf die erfassten Daten finden Sie in der Trace-API für Eingabemethoden.

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

void update()

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