QVirtualKeyboardInputEngine Class

Member Function Documentation

Qt::Key QVirtualKeyboardInputEngine::activeKey() const

Returns the currently active key, or Qt::Key_unknown if no key is active.

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

Indicates that the active key has changed.

QVirtualKeyboardInputContext *QVirtualKeyboardInputEngine::inputContext() const

Returns the InputContext instance associated with the input engine.

QVirtualKeyboardAbstractInputMethod *QVirtualKeyboardInputEngine::inputMethod() const

Returns the active input method.

See also setInputMethod().

[signal] void QVirtualKeyboardInputEngine::inputMethodChanged()

Indicates that the input method has changed.

[signal] void QVirtualKeyboardInputEngine::inputMethodReset()

Emitted when the input method needs to be reset.

[signal] void QVirtualKeyboardInputEngine::inputMethodUpdate()

[signal] void QVirtualKeyboardInputEngine::inputModeChanged()

Indicates that the input mode has changed.

QList<int> QVirtualKeyboardInputEngine::inputModes() const

Returns the list of available input modes.

[signal] void QVirtualKeyboardInputEngine::inputModesChanged()

Indicates that the available input modes have changed.

QList<int> QVirtualKeyboardInputEngine::patternRecognitionModes() const

Returns list of supported pattern recognition modes.

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

Indicates that the available pattern recognition modes have changed.

This function was introduced in QtQuick.VirtualKeyboard 2.0.

Qt::Key QVirtualKeyboardInputEngine::previousKey() const

Returns the previously active key, or Qt::Key_unknown if no key has been active.

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

Indicates that the previous key has changed.

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

This function attempts to reselect a word located at the cursorPosition. The reselectFlags define the rules for how the word should be selected in relation to the cursor position.

The function returns true if the word was successfully reselected.

This function was introduced in QtQuick.VirtualKeyboard 2.0.

void QVirtualKeyboardInputEngine::setInputMethod(QVirtualKeyboardAbstractInputMethod *inputMethod)

Sets inputMethod as the active input method.

See also inputMethod().

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

Starts a trace interaction with the input engine.

The trace is uniquely identified by the traceId. The input engine will assign the id to the QVirtualKeyboardTrace object if the input method accepts the event.

The patternRecognitionMode specifies the recognition mode used for the pattern.

If the current input method accepts the event it returns a QVirtualKeyboardTrace object associated with this interaction. If the input method discards the event, it returns a NULL value.

The traceCaptureDeviceInfo provides information about the source device and the traceScreenInfo provides information about the screen context.

By definition, the QVirtualKeyboardTrace object remains valid until the traceEnd() method is called.

The trace interaction is ended by calling the traceEnd() method.

This function was introduced in QtQuick.VirtualKeyboard 2.0.

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

Ends the trace interaction with the input engine.

The trace object may be discarded at any point after calling this function.

The function returns true if the trace interaction was accepted (i.e. the touch events should not be used for anything else).

[invokable] void QVirtualKeyboardInputEngine::virtualKeyCancel()

Reverts the active key state without emitting the key event. This method is useful when the user discards the current key and the key state needs to be restored.

[invokable] bool QVirtualKeyboardInputEngine::virtualKeyClick(Qt::Key key, const QString &text, Qt::KeyboardModifiers modifiers)

Emits a key click event for the given key, text and modifiers. Returns true if the key event was accepted by the input engine.

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

Indicates that the virtual key was clicked with the given text and modifiers. The isAutoRepeat indicates if the event is automatically repeated while the key is being pressed. This signal is emitted after the input method has processed the key event.

[invokable] bool QVirtualKeyboardInputEngine::virtualKeyPress(Qt::Key key, const QString &text, Qt::KeyboardModifiers modifiers, bool repeat)

Called by the keyboard layer to indicate that key was pressed, with the given text and modifiers.

The key is set as an active key (down key). The actual key event is triggered when the key is released by the virtualKeyRelease() method. The key press event can be discarded by calling virtualKeyCancel().

The key press also initiates the key repeat timer if repeat is true.

Returns true if the key was accepted by this input engine.

See also virtualKeyCancel() and virtualKeyRelease().

[invokable] bool QVirtualKeyboardInputEngine::virtualKeyRelease(Qt::Key key, const QString &text, Qt::KeyboardModifiers modifiers)

Releases the key at key. The method emits a key event for the input method if the event has not been generated by a repeating timer. The text and modifiers are passed to the input method.

Returns true if the key was accepted by the input engine.