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 |
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() |
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.
© 2024 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.