Back to Qt.io
Contact Us Blog Download Qt
Auf dieser Seite

InputEngine QML Type (Uncreatable)

Ordnet die Benutzereingaben den Eingabemethoden zu. Mehr...

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

Hinweis: Dies ist ein nicht erstellbarer Typ. Er kann in QML nicht instanziiert werden.

Eigenschaften

Signale

Methoden

Ausführliche Beschreibung

Die Eingabe-Engine ist dafür zuständig, Eingabeereignisse an die Eingabemethoden weiterzuleiten. Die eigentliche Eingabelogik wird von den Eingabemethoden umgesetzt.

Die Eingabe-Engine umfasst auch die Standard-Eingabemethode, die die Standardverarbeitung übernimmt, falls die aktive Eingabemethode das Ereignis nicht verarbeitet.

Dokumentation der Eigenschaften

activeKey : int [read-only]

Derzeit 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 “ liefert eine Liste der gültigen Eingabemodi für die aktuelle Eingabemethode und die aktuelle Ländereinstellung.

Die vordefinierten Eingabemodi sind:

  • InputEngine.InputMode.Latin Der Standard-Eingabemodus für lateinischen Text.
  • InputEngine.InputMode.Numeric Es ist nur die numerische Eingabe zulässig.
  • InputEngine.InputMode.Dialable Es ist nur die Eingabe per Wählcode 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 Eingabemodus „Vollbreite-Latein“ 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 Thailändischer Eingabemodus.
  • InputEngine.InputMode.Stroke Strich-Eingabemodus für Chinesisch.
  • InputEngine.InputMode.Romaji Romaji-Eingabemodus für Japanisch.
  • InputEngine.InputMode.HiraganaFlick Flick-Eingabemodus für Japanisch.

inputModes : list<int> [read-only]

Die Liste der verfügbaren Eingabemodi hängt von der Eingabemethode und der Ländereinstellung ab. Diese Eigenschaft wird aktualisiert, sobald sich eine der beiden 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]

Zuletzt gedrückte Taste.

wordCandidateListModel : SelectionListModel [read-only]

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

wordCandidateListVisibleHint : bool [read-only]

Verwenden Sie diese Eigenschaft, um festzulegen, ob die Liste der Wortvorschläge in der Benutzeroberfläche angezeigt werden soll.

Signal-Dokumentation

void activeKeyChanged(int key)

Zeigt an, dass sich der 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 den Methoden ` QVirtualKeyboardAbstractInputMethod::reset()` und ` InputMethod::reset()` verknüpft, sobald die Eingabemethode aktiviert wird.

Hinweis: Der entsprechende Handler ist ` onInputMethodReset`.

void inputMethodUpdate()

Hinweis: Dieses Signal wird automatisch mit „ QVirtualKeyboardAbstractInputMethod::update()“ und „ InputMethod::update()“ verknüpft, sobald die Eingabemethode aktiviert wird.

Hinweis: Der entsprechende Handler lautet onInputMethodUpdate.

void inputModeChanged()

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

Hinweis: Der entsprechende Handler lautet „ onInputModeChanged “.

void inputModesChanged()

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

Hinweis: Der entsprechende Handler lautet „ 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 „ .PatternRecognitionMode.None“ InputEngine
  • InputEngine.PatternRecognitionMode.Handwriting Mustererkennungsmodus für die Handschrifterkennung.
  • InputEngine.PatternRecognitionMode.HandwritingRecoginition obsolete Verwenden Sie „ .PatternRecognitionMode.Handwriting“ InputEngine

Hinweis: Der entsprechende Handler lautet „ 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 lautet „ onPreviousKeyChanged “.

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

Gibt an, dass auf den virtuellen „ key “ mit den angegebenen Werten „ text “ und „ modifiers “ geklickt wurde. Dieses Signal wird ausgegeben, nachdem die Eingabemethode das Tastenereignis verarbeitet hat.

Hinweis: Der entsprechende Handler ist „ onVirtualKeyClicked “.

Methodendokumentation

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

Stellt eine Trace-Interaktion mit der Eingabe-Engine her.

Die Trace-Interaktion wird durch die „ traceId “ eindeutig identifiziert. Die Eingabe-Engine weist dem Trace-Objekt die ID zu, sofern die Eingabemethode das Ereignis akzeptiert.

Die „ patternRecognitionMode “ gibt den für das Muster verwendeten Erkennungsmodus an.

Wenn die aktuelle Eingabemethode das Ereignis akzeptiert, gibt sie ein Trace-Objekt zurück, das dieser Interaktion zugeordnet ist. Wenn die Eingabemethode das Ereignis verwirft, gibt sie den Wert „null“ zurück.

Die Methode „ traceCaptureDeviceInfo “ liefert Informationen zum Quellgerät, und die Methode „ traceScreenInfo “ liefert Informationen zum 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 nach dem Aufruf dieser Funktion jederzeit verworfen werden.

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

void virtualKeyCancel()

Setzt den Status der aktiven Taste zurück, ohne das Tastenereignis auszulösen. Diese Methode ist nützlich, wenn der Benutzer die aktuelle Taste loslässt und der Status der Taste wiederhergestellt werden muss.

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

Löst ein Tastenklick-Ereignis für die angegebenen Werte „ key “, „ text “ und „ modifiers “ aus. Gibt „ true “ zurück, wenn das Tastenereignis von der Eingabe-Engine akzeptiert wurde.

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

Wird von der Tastaturebene aufgerufen, um anzuzeigen, dass die Taste „ key “ gedrückt wurde, mit den angegebenen Werten für „ text “ und „ modifiers “.

Die Taste „ key “ wird als aktive Taste (gedrückte Taste) festgelegt. Das eigentliche Tastenereignis wird ausgelöst, wenn die Taste durch die Methode „ virtualKeyRelease()“ losgelassen wird. Das Tastendruckereignis kann durch Aufruf von „ virtualKeyCancel()“ verworfen werden.

Der Tastendruck löst außerdem den Wiederholungstimer aus, wenn ` repeat ` auf ` true` gesetzt ist.

Gibt ` true ` zurück, wenn die Taste von dieser Eingabe-Engine akzeptiert wurde.

Siehe auch virtualKeyCancel() und virtualKeyRelease().

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

Löst die Taste unter key aus. Die Methode löst ein Tastenereignis für die Eingabemethode aus, sofern das Ereignis nicht durch einen sich wiederholenden Timer erzeugt wurde. Die Parameter „ text “ und „ modifiers “ werden an die Eingabemethode übergeben.

Gibt „ true “ zurück, wenn die Taste von der Eingabe-Engine akzeptiert wurde.

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