- Qt 6.12
- Qt Virtual Keyboard
- C++ Classes
- QVirtualKeyboardInputContext
- Qt Virtual Keyboard | Commercial or GPLv3

# QVirtualKeyboardInputContext Class

Provides access to an input context. More...

Header: | `#include <QVirtualKeyboardInputContext>`
CMake: | `find_package(Qt6 REQUIRED COMPONENTS VirtualKeyboard)` `target_link_libraries(mytarget PRIVATE Qt6::VirtualKeyboard)`
qmake: | `QT += virtualkeyboard`
In QML: | InputContext
Inherits: | QObject

- List of all members, including inherited members
- Deprecated members

## Properties

anchorPosition : int anchorRectIntersectsClipRect : bool anchorRectangle : QRectF animating : bool capsLockActive : bool cursorPosition : int cursorRectIntersectsClipRect : bool cursorRectangle : QRectF inputEngine : QVirtualKeyboardInputEngine* const | inputMethodHints : Qt::InputMethodHints `(since 6.1)` keyboardObserver : QVirtualKeyboardObserver* const locale : QString preeditText : QString selectedText : QString selectionControlVisible : bool shiftActive : bool surroundingText : QString uppercase : bool

## Public Functions

int | anchorPosition() const
bool | anchorRectIntersectsClipRect() const
QRectF | anchorRectangle() const
void | clear()
void | commit()
void | commit(const QString &text, int replaceFrom = 0, int replaceLength = 0)
int | cursorPosition() const
bool | cursorRectIntersectsClipRect() const
QRectF | cursorRectangle() const
QVirtualKeyboardInputEngine * | inputEngine() const
Qt::InputMethodHints | inputMethodHints() const
bool | isAnimating() const
bool | isCapsLockActive() const
bool | isSelectionControlVisible() const
bool | isShiftActive() const
bool | isUppercase() const
QVirtualKeyboardObserver * | keyboardObserver() const
QString | locale() const
QString | preeditText() const
QString | selectedText() const
void | sendKeyClick(int key, const QString &text, int modifiers = 0)
void | setAnimating(bool isAnimating)
void | setPreeditText(const QString &text, QList<QInputMethodEvent::Attribute> attributes = QList<QInputMethodEvent::Attribute>(), int replaceFrom = 0, int replaceLength = 0)
QString | surroundingText() const

## Signals

void | anchorPositionChanged()
void | anchorRectIntersectsClipRectChanged()
void | anchorRectangleChanged()
void | animatingChanged()
void | capsLockActiveChanged()
void | cursorPositionChanged()
void | cursorRectIntersectsClipRectChanged()
void | cursorRectangleChanged()
void | inputMethodHintsChanged()
void | localeChanged()
void | preeditTextChanged()
void | selectedTextChanged()
void | selectionControlVisibleChanged()
void | shiftActiveChanged()
void | surroundingTextChanged()
void | uppercaseChanged()

## Detailed Description

## Property Documentation

### `[read-only]` anchorPosition : int

This property holds the anchor position.

This property is changed when the anchor position changes.

Access functions:

int | anchorPosition() const

Notifier signal:

void | anchorPositionChanged()

### `[read-only]` anchorRectIntersectsClipRect : bool

Holds `true` if the bounding rectangle of the selection anchor intersects the exposed input item rectangle.

Access functions:

bool | anchorRectIntersectsClipRect() const

Notifier signal:

void | anchorRectIntersectsClipRectChanged()

See also Qt::ImAnchorRectangle and Qt::ImInputItemClipRectangle.

### `[read-only]` anchorRectangle : QRectF

This property holds the anchor rectangle.

This property is changed when the anchor rectangle changes.

Access functions:

QRectF | anchorRectangle() const

Notifier signal:

void | anchorRectangleChanged()

### animating : bool

This property holds the animating status.

Use this property to set the animating status, for example during UI transitioning states.

Access functions:

bool | isAnimating() const
void | setAnimating(bool isAnimating)

Notifier signal:

void | animatingChanged()

### `[read-only]` capsLockActive : bool

This property holds the caps lock status.

This property is changed when the caps lock status changes.

Access functions:

bool | isCapsLockActive() const

Notifier signal:

void | capsLockActiveChanged()

### `[read-only]` cursorPosition : int

This property holds the cursor position.

This property is changed when the cursor position changes.

Access functions:

int | cursorPosition() const

Notifier signal:

void | cursorPositionChanged()

### `[read-only]` cursorRectIntersectsClipRect : bool

Holds `true` if the bounding rectangle of the input cursor intersects the exposed input item rectangle.

Access functions:

bool | cursorRectIntersectsClipRect() const

Notifier signal:

void | cursorRectIntersectsClipRectChanged()

See also Qt::ImCursorRectangle and Qt::ImInputItemClipRectangle.

### `[read-only]` cursorRectangle : QRectF

This property holds the cursor rectangle.

This property is changed when the cursor rectangle changes.

Access functions:

QRectF | cursorRectangle() const

Notifier signal:

void | cursorRectangleChanged()

### `[read-only]` inputEngine : QVirtualKeyboardInputEngine* const

This property holds the input engine.

This property stores the input engine.

Access functions:

QVirtualKeyboardInputEngine * | inputEngine() const

### `[read-only]` inputMethodHints : Qt::InputMethodHints

This property holds the input method hints.

This property is changed when the input method hints changes.

Access functions:

Qt::InputMethodHints | inputMethodHints() const

Notifier signal:

void | inputMethodHintsChanged()

### `[read-only, since 6.1]` keyboardObserver : QVirtualKeyboardObserver* const

Holds the keyboard observer object, which can be used to receive notifications of keyboard change events.

This enumeration was introduced in Qt 6.1.

Access functions:

QVirtualKeyboardObserver * | keyboardObserver() const

### `[read-only]` locale : QString

This property holds the locale.

This property is changed when the input locale changes.

Access functions:

QString | locale() const

Notifier signal:

void | localeChanged()

### preeditText : QString

This property holds the pre-edit text.

This property sets the pre-edit text.

Access functions:

QString | preeditText() const
void | setPreeditText(const QString &text, QList<QInputMethodEvent::Attribute> attributes = QList<QInputMethodEvent::Attribute>(), int replaceFrom = 0, int replaceLength = 0)

Notifier signal:

void | preeditTextChanged()

### `[read-only]` selectedText : QString

This property holds the selected text.

This property is changed when the selected text changes.

Access functions:

QString | selectedText() const

Notifier signal:

void | selectedTextChanged()

### `[read-only]` selectionControlVisible : bool

Holds `true` if the selection control is currently visible.

Access functions:

bool | isSelectionControlVisible() const

Notifier signal:

void | selectionControlVisibleChanged()

### `[read-only]` shiftActive : bool

This property holds the shift status.

This property is changed when the shift status changes.

Access functions:

bool | isShiftActive() const

Notifier signal:

void | shiftActiveChanged()

### `[read-only]` surroundingText : QString

This property holds the surrounding text around cursor.

This property is changed when the surrounding text around the cursor changes.

Access functions:

QString | surroundingText() const

Notifier signal:

void | surroundingTextChanged()

### `[read-only]` uppercase : bool

This property holds the uppercase status.

This property is `true` when either shiftActive or capsLockActive is `true`.

Access functions:

bool | isUppercase() const

Notifier signal:

void | uppercaseChanged()

## Member Function Documentation

### `[invokable]` void QVirtualKeyboardInputContext::clear()

Clears the pre-edit text.

Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.

### `[invokable]` void QVirtualKeyboardInputContext::commit()

Commits the current pre-edit text.

Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.

### `[invokable]` void QVirtualKeyboardInputContext::commit(const QString &text, int replaceFrom = 0, int replaceLength = 0)

Commits the final text to the input item and optionally modifies the text relative to the start of the pre-edit text. If replaceFrom is non-zero, the text replaces the contents relative to replaceFrom with a length of replaceLength.

Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.

### `[invokable]` void QVirtualKeyboardInputContext::sendKeyClick(int key, const QString &text, int modifiers = 0)

Sends a key click event with the given key, text and modifiers to the input item that currently has focus.

Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.