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

# QVirtualKeyboardInputContext Class

Provides access to an input context. More...

Header: | #include <QVirtualKeyboardInputContext>
qmake: | QT += virtualkeyboard
Instantiated By: | InputContext

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

## Properties

- anchorPosition : const int
- anchorRectIntersectsClipRect : const bool
- anchorRectangle : const QRectF
- animating : bool
- capsLockActive : const bool
- cursorPosition : const int
- cursorRectIntersectsClipRect : const bool
- cursorRectangle : const QRectF
- inputEngine : QVirtualKeyboardInputEngine* const

- inputMethodHints : const Qt::InputMethodHints
- locale : const QString
- preeditText : QString
- selectedText : const QString
- selectionControlVisible : const bool
- shiftActive : const bool
- surroundingText : const QString
- uppercase : const 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
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

### anchorPosition : const 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()

### anchorRectIntersectsClipRect : const 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.

### anchorRectangle : const 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()

### capsLockActive : const 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()

### cursorPosition : const 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()

### cursorRectIntersectsClipRect : const 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.

### cursorRectangle : const 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()

### inputEngine : QVirtualKeyboardInputEngine* const

This property holds the input engine.

This property stores the input engine.

Access functions:

QVirtualKeyboardInputEngine * | inputEngine() const

### inputMethodHints : const 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()

### locale : const 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()

### selectedText : const 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()

### selectionControlVisible : const bool

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

Access functions:

bool | isSelectionControlVisible() const

Notifier signal:

void | selectionControlVisibleChanged()

### shiftActive : const 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()

### surroundingText : const 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()

### uppercase : const 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

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

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

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

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