Back to Qt.io
Contact Us Blog Download Qt

InputEngine QML Type

Ordnet die Benutzereingabe den Eingabemethoden zu. Mehr...

Import Statement: import QtQuick.VirtualKeyboard
In C++: QVirtualKeyboardInputEngine

Eigenschaften

Signale

Methoden

Detaillierte Beschreibung

Die Eingabe-Engine ist für die Weiterleitung von Eingabeereignissen an Eingabemethoden zuständig. Die eigentliche Eingabelogik wird von den Eingabemethoden implementiert.

Die Eingabe-Engine umfasst auch die Standard-Eingabemethode, die für die Standardverarbeitung sorgt, wenn die aktive Eingabemethode das Ereignis nicht verarbeitet.

Dokumentation der Eigenschaft

activeKey : int [read-only]

Aktuell gedrückte Taste.


inputMethod : InputMethod

Verwenden Sie diese Eigenschaft, um die aktive Eingabemethode festzulegen oder um zu überwachen, wann sich die aktive Eingabemethode ändert.


inputMode : int

Verwenden Sie diese Eigenschaft, um den aktuellen Eingabemodus abzurufen oder festzulegen. Die Eigenschaft InputEngine::inputModes enthält die Liste der gültigen Eingabemodi für die aktuelle Eingabemethode und das Gebietsschema.

Die vordefinierten Eingabemodi sind:

  • InputEngine.InputMode.Latin Der Standard-Eingabemodus für lateinischen Text.
  • InputEngine.InputMode.Numeric Nur numerische Eingaben sind erlaubt.
  • InputEngine.InputMode.Dialable Nur wählbare Eingaben sind erlaubt.
  • InputEngine.InputMode.Pinyin Pinyin-Eingabemodus für Chinesisch.
  • InputEngine.InputMode.Cangjie Cangjie-Eingabemodus für Chinesisch.
  • InputEngine.InputMode.Zhuyin Zhuyin-Eingabemodus für Chinesisch.
  • InputEngine.InputMode.Hangul Hangul-Eingabemodus für Koreanisch.
  • InputEngine.InputMode.Hiragana Hiragana-Eingabemodus für Japanisch.
  • InputEngine.InputMode.Katakana Katakana-Eingabemodus für Japanisch.
  • InputEngine.InputMode.FullwidthLatin Lateineingabemodus in voller Breite für ostasiatische Sprachen.
  • InputEngine.InputMode.Greek Griechischer Eingabemodus.
  • InputEngine.InputMode.Cyrillic Kyrillischer Eingabemodus.
  • InputEngine.InputMode.Arabic Arabischer Eingabemodus.
  • InputEngine.InputMode.Hebrew Hebräischer Eingabemodus.
  • InputEngine.InputMode.ChineseHandwriting Chinesische Handschrift.
  • InputEngine.InputMode.JapaneseHandwriting Japanische Handschrift.
  • InputEngine.InputMode.KoreanHandwriting Koreanische Handschrift.
  • InputEngine.InputMode.Thai Thai-Eingabemodus.
  • InputEngine.InputMode.Stroke Stroke-Eingabemodus für Chinesisch.
  • InputEngine.InputMode.Romaji Romaji-Eingabemodus für Japanisch.

inputModes : list<int> [read-only]

Die Liste der verfügbaren Eingabemodi ist abhängig von der Eingabemethode und dem Gebietsschema. Diese Eigenschaft wird aktualisiert, wenn sich eine der Abhängigkeiten ändert.


patternRecognitionModes : list<int> [read-only, since QtQuick.VirtualKeyboard 2.0]

Die Liste der verfügbaren Mustererkennungsmodi.

Mögliche Werte:

KonstantBeschreibung
InputEngine.PatternRecognitionMode.NoneDie Mustererkennung ist nicht verfügbar.
InputEngine.PatternRecognitionMode.PatternRecognitionDisabledobsolete - Verwenden Sie stattdessen None.
InputEngine.PatternRecognitionMode.HandwritingMustererkennungsmodus für die Handschrifterkennung.
InputEngine.PatternRecognitionMode.HandwritingRecoginitionobsolete - Verwenden Sie stattdessen Handwriting.

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


previousKey : int [read-only]

Zuvor gedrückte Taste.


wordCandidateListModel : SelectionListModel [read-only]

Verwenden Sie diese Eigenschaft, um auf das Listenmodell für die Wortkandidatenliste zuzugreifen.


wordCandidateListVisibleHint : bool [read-only]

Verwenden Sie diese Eigenschaft, um zu prüfen, ob die Wortkandidatenliste in der Benutzeroberfläche sichtbar sein soll.


Signal Dokumentation

void activeKeyChanged(int key)

Zeigt an, dass sich das aktive key geändert hat.

Hinweis: Der entsprechende Handler ist onActiveKeyChanged.


void inputMethodChanged()

Zeigt an, dass sich die Eingabemethode geändert hat.

Hinweis: Der entsprechende Handler ist onInputMethodChanged.


void inputMethodReset()

Wird ausgegeben, wenn die Eingabemethode zurückgesetzt werden muss.

Hinweis: Dieses Signal wird automatisch mit QVirtualKeyboardAbstractInputMethod::reset() und InputMethod::reset() verbunden, wenn die Eingabemethode aktiviert wird.

Hinweis: Der entsprechende Handler ist onInputMethodReset.


void inputMethodUpdate()

Hinweis: Dieses Signal wird automatisch mit QVirtualKeyboardAbstractInputMethod::update() und InputMethod::update() verbunden, wenn die Eingabemethode aktiviert wird.

Hinweis: Der entsprechende Handler ist onInputMethodUpdate.


void inputModeChanged()

Zeigt an, dass sich der Eingabemodus geändert hat.

Hinweis: Der entsprechende Handler ist onInputModeChanged.


void inputModesChanged()

Zeigt an, dass sich die verfügbaren Eingabemodi geändert haben.

Hinweis: Der entsprechende Handler ist onInputModesChanged.


[since QtQuick.VirtualKeyboard 2.0] void patternRecognitionModesChanged()

Zeigt an, dass sich die verfügbaren Mustererkennungsmodi geändert haben.

Die vordefinierten Mustererkennungsmodi sind:

  • InputEngine.PatternRecognitionMode.None Die Mustererkennung ist nicht verfügbar.
  • InputEngine.PatternRecognitionMode.PatternRecognitionDisabled obsolete Verwenden Sie InputEngine.PatternRecognitionMode.None
  • InputEngine.PatternRecognitionMode.Handwriting Mustererkennungsmodus für die Handschrifterkennung.
  • InputEngine.PatternRecognitionMode.HandwritingRecoginition obsolete Verwenden Sie InputEngine.PatternRecognitionMode.Handwriting

Hinweis: Der entsprechende Handler ist onPatternRecognitionModesChanged.

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


void previousKeyChanged(int key)

Zeigt an, dass sich der vorherige key geändert hat.

Hinweis: Der entsprechende Handler ist onPreviousKeyChanged.


void virtualKeyClicked(int key, string text, int modifiers)

Zeigt an, dass das virtuelle key mit den angegebenen text und modifiers angeklickt wurde. Dieses Signal wird ausgegeben, nachdem die Eingabemethode das Tastenereignis verarbeitet hat.

Hinweis: Der entsprechende Handler ist onVirtualKeyClicked.


Dokumentation der Methode

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

Startet eine Trace-Interaktion mit der Input-Engine.

Die Ablaufverfolgung wird durch die traceId eindeutig identifiziert. Die Eingabemaschine weist die ID dem Ablaufverfolgungsobjekt zu, wenn die Eingabemethode das Ereignis akzeptiert.

Die patternRecognitionMode gibt den Erkennungsmodus an, der für das Muster verwendet wird.

Wenn die aktuelle Eingabemethode das Ereignis akzeptiert, gibt sie ein mit dieser Interaktion verbundenes Trace-Objekt zurück. Wenn die Eingabemethode das Ereignis verwirft, gibt sie einen Nullwert zurück.

Die traceCaptureDeviceInfo liefert Informationen über das Quellgerät und die traceScreenInfo liefert Informationen über den Bildschirmkontext.

Per Definition bleibt das Trace-Objekt gültig, bis die Methode traceEnd() aufgerufen wird.

Die Trace-Interaktion wird durch den Aufruf der Methode InputEngine.traceEnd() beendet.

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


bool traceEnd(Trace trace)

Beendet die Trace-Interaktion mit der Eingabe-Engine.

Das trace Objekt kann zu jedem Zeitpunkt nach dem Aufruf dieser Funktion verworfen werden.

Die Funktion gibt true zurück, wenn die Trace-Interaktion akzeptiert wurde (d.h. die Touch-Ereignisse sollten nicht für etwas anderes verwendet werden).


void virtualKeyCancel()

Stellt den Zustand der aktiven Taste wieder her, ohne das Tastenereignis auszulösen. Diese Methode ist nützlich, wenn der Benutzer die aktuelle Taste verwirft und der Tastenzustand wiederhergestellt werden muss.


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

Sendet ein Tastenklick-Ereignis für die angegebenen key, text und modifiers. Gibt true zurück, wenn das Tastenereignis von der Eingabemaschine akzeptiert wurde.


bool virtualKeyPress(int key, string text, int modifiers, bool repeat)

Wird von der Tastaturebene aufgerufen, um anzuzeigen, dass key gedrückt wurde, mit den angegebenen text und modifiers.

Die key wird als aktive Taste (Abwärtstaste) festgelegt. Das eigentliche Tastenereignis wird ausgelöst, wenn die Taste mit der Methode virtualKeyRelease() losgelassen wird. Das Ereignis des Tastendrucks kann durch den Aufruf von virtualKeyCancel() verworfen werden.

Der Tastendruck löst auch den Timer für die Tastenwiederholung aus, wenn repeat true ist.

Gibt true zurück, wenn die Taste von diesem Eingabegerät akzeptiert wurde.

Siehe auch virtualKeyCancel() und virtualKeyRelease().


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

Gibt die Taste unter key frei. Die Methode gibt ein Schlüsselereignis für die Eingabemethode aus, wenn das Ereignis nicht durch einen Wiederholungstimer erzeugt wurde. Die Werte text und modifiers werden an die Eingabemethode übergeben.

Gibt true zurück, wenn der Schlüssel von der Eingabemaschine akzeptiert wurde.


© 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.