W3cubDocs

/Qt

QVirtualKeyboardInputContext Class

Provides access to an input context. More...

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

Properties

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 : 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()

[read-only] 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.

[read-only] 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()

[read-only] 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()

[read-only] 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()

[read-only] 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.

[read-only] 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()

[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 : 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()

[read-only, since QtQuick.VirtualKeyboard 6.1] keyboardObserver : QVirtualKeyboardObserver* const

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

This property was introduced in QtQuick.VirtualKeyboard 6.1.

Access functions:

QVirtualKeyboardObserver * keyboardObserver() const

[read-only] 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()

[read-only] 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()

[read-only] selectionControlVisible : const bool

Holds true if the selection control is currently visible.

Access functions:

bool isSelectionControlVisible() const

Notifier signal:

void selectionControlVisibleChanged()

[read-only] 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()

[read-only] 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()

[read-only] 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

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

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.2/qvirtualkeyboardinputcontext.html