QVirtualKeyboardInputEngine Class

Dokumentation der Member-Funktionen

Qt::Key QVirtualKeyboardInputEngine::activeKey() const

Gibt den derzeit aktiven Schlüssel zurück oder „ Qt::Key_unknown “, falls kein Schlüssel aktiv ist.

[signal] void QVirtualKeyboardInputEngine::activeKeyChanged(Qt::Key key)

Zeigt an, dass sich die aktive Eigenschaft „ key “ geändert hat.

QVirtualKeyboardInputContext *QVirtualKeyboardInputEngine::inputContext() const

Gibt die mit der Eingabe-Engine verknüpfte „ InputContext “-Instanz zurück.

QVirtualKeyboardAbstractInputMethod *QVirtualKeyboardInputEngine::inputMethod() const

Gibt die aktive Eingabemethode zurück.

Siehe auch „ setInputMethod()“.

[signal] void QVirtualKeyboardInputEngine::inputMethodChanged()

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

[signal] void QVirtualKeyboardInputEngine::inputMethodReset()

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

[signal] void QVirtualKeyboardInputEngine::inputMethodUpdate()

[signal] void QVirtualKeyboardInputEngine::inputModeChanged()

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

QList<int> QVirtualKeyboardInputEngine::inputModes() const

Gibt die Liste der verfügbaren Eingabemodi zurück.

[signal] void QVirtualKeyboardInputEngine::inputModesChanged()

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

QList<int> QVirtualKeyboardInputEngine::patternRecognitionModes() const

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

[signal, since QtQuick.VirtualKeyboard 2.0] void QVirtualKeyboardInputEngine::patternRecognitionModesChanged()

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

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

Qt::Key QVirtualKeyboardInputEngine::previousKey() const

Gibt den zuletzt aktiven Schlüssel zurück oder „ Qt::Key_unknown “, falls kein Schlüssel aktiv war.

[signal] void QVirtualKeyboardInputEngine::previousKeyChanged(Qt::Key key)

Zeigt an, dass sich die vorherige Eigenschaft „ key “ geändert hat.

[invokable, since QtQuick.VirtualKeyboard 2.0] bool QVirtualKeyboardInputEngine::reselect(int cursorPosition, const QVirtualKeyboardInputEngine::ReselectFlags &reselectFlags)

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

Die Funktion gibt „ true “ zurück, wenn das Wort erfolgreich erneut ausgewählt wurde.

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

void QVirtualKeyboardInputEngine::setInputMethod(QVirtualKeyboardAbstractInputMethod *inputMethod)

Legt „ inputMethod “ als aktive Eingabemethode fest.

Siehe auch inputMethod().

[invokable, since QtQuick.VirtualKeyboard 2.0] QVirtualKeyboardTrace *QVirtualKeyboardInputEngine::traceBegin(int traceId, QVirtualKeyboardInputEngine::PatternRecognitionMode patternRecognitionMode, const QVariantMap &traceCaptureDeviceInfo, const QVariantMap &traceScreenInfo)

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

Die Trace-Interaktion wird durch die „ traceId “ eindeutig identifiziert. Die Eingabe-Engine weist dem „ QVirtualKeyboardTrace “-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 „ QVirtualKeyboardTrace “-Objekt zurück, das dieser Interaktion zugeordnet ist. Wenn die Eingabemethode das Ereignis verwirft, gibt sie den Wert NULL zurück.

Das „ traceCaptureDeviceInfo “-Objekt liefert Informationen zum Quellgerät, und das „ traceScreenInfo “-Objekt liefert Informationen zum Bildschirmkontext.

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

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

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

[invokable] bool QVirtualKeyboardInputEngine::traceEnd(QVirtualKeyboardTrace *trace)

Beendet die Trace-Interaktion mit der Eingabe-Engine.

Das Objekt „ trace “ kann nach dem Aufruf dieser Funktion jederzeit verworfen werden.

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

[invokable] void QVirtualKeyboardInputEngine::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 verwirft und der Tastenzustand wiederhergestellt werden muss.

[invokable] bool QVirtualKeyboardInputEngine::virtualKeyClick(Qt::Key key, const QString &text, Qt::KeyboardModifiers 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.

[signal] void QVirtualKeyboardInputEngine::virtualKeyClicked(Qt::Key key, const QString &text, Qt::KeyboardModifiers modifiers, bool isAutoRepeat)

Gibt an, dass auf das virtuelle „ key “ mit den angegebenen Werten „ text “ und „ modifiers “ geklickt wurde. Der Wert „ isAutoRepeat “ gibt an, ob das Ereignis automatisch wiederholt wird, solange die Taste gedrückt gehalten wird. Dieses Signal wird ausgegeben, nachdem die Eingabemethode das Tastenereignis verarbeitet hat.

[invokable] bool QVirtualKeyboardInputEngine::virtualKeyPress(Qt::Key key, const QString &text, Qt::KeyboardModifiers 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 über die Methode „ virtualKeyRelease()“ losgelassen wird. Das Tastendruckereignis kann durch Aufruf von „ virtualKeyCancel()“ verworfen werden.

Der Tastendruck löst außerdem den Tastendruck-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()“.

[invokable] bool QVirtualKeyboardInputEngine::virtualKeyRelease(Qt::Key key, const QString &text, Qt::KeyboardModifiers 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 generiert wurde. Die Parameter „ text “ und „ modifiers “ werden an die Eingabemethode übergeben.

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