QVirtualKeyboardInputContext Class
提供对输入上下文的访问。更多
| 头文件： | #include <QVirtualKeyboardInputContext> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS VirtualKeyboard)target_link_libraries(mytarget PRIVATE Qt6::VirtualKeyboard) |
| qmake： | QT += virtualkeyboard |
| 在 QML 中： | InputContext |
| 继承： | QObject |
属性
|
|
公共功能
| 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 |
信号
| 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() |
属性文档
[read-only] anchorPosition : const int
该属性用于保存锚点位置。
当锚点位置发生变化时，该属性也会发生变化。
访问功能：
| int | anchorPosition() const |
通知信号：
| void | anchorPositionChanged() |
[read-only] anchorRectIntersectsClipRect : const bool
如果选择锚点的边界矩形与暴露的输入项矩形相交，则保持true 。
访问功能：
| bool | anchorRectIntersectsClipRect() const |
通知信号：
| void | anchorRectIntersectsClipRectChanged() |
另请参阅 Qt::ImAnchorRectangle 和Qt::ImInputItemClipRectangle 。
[read-only] anchorRectangle : const QRectF
该属性用于保存锚点矩形。
当锚点矩形发生变化时，该属性也会发生变化。
访问功能：
| QRectF | anchorRectangle() const |
通知信号：
| void | anchorRectangleChanged() |
animating : bool
该属性用于保存动画状态。
使用该属性可设置动画状态，例如在 UI 过渡状态时。
访问功能：
| bool | isAnimating() const |
| void | setAnimating(bool isAnimating) |
通知信号：
| void | animatingChanged() |
[read-only] capsLockActive : const bool
该属性用于保存大写锁定状态。
大写锁定状态改变时，该属性也会改变。
访问功能：
| bool | isCapsLockActive() const |
通知信号：
| void | capsLockActiveChanged() |
[read-only] cursorPosition : const int
该属性用于保存光标位置。
当光标位置发生变化时，该属性也会发生变化。
访问功能：
| int | cursorPosition() const |
通知信号：
| void | cursorPositionChanged() |
[read-only] cursorRectIntersectsClipRect : const bool
如果输入光标的边界矩形与暴露的输入项矩形相交，则保持true 。
访问功能：
| bool | cursorRectIntersectsClipRect() const |
通知信号：
| void | cursorRectIntersectsClipRectChanged() |
另请参阅 Qt::ImCursorRectangle 和Qt::ImInputItemClipRectangle 。
[read-only] cursorRectangle : const QRectF
该属性用于保存光标矩形。
当光标矩形发生变化时，该属性也会发生变化。
访问功能：
| QRectF | cursorRectangle() const |
通知信号：
| void | cursorRectangleChanged() |
[read-only] inputEngine : QVirtualKeyboardInputEngine* const
此属性保存输入引擎。
此属性存储输入引擎。
访问功能：
| QVirtualKeyboardInputEngine * | inputEngine() const |
[read-only] inputMethodHints : const Qt::InputMethodHints
该属性用于保存输入法提示。
当输入法提示发生变化时，该属性也会发生变化。
访问功能：
| Qt::InputMethodHints | inputMethodHints() const |
Notifier 信号：
| void | inputMethodHintsChanged() |
[read-only, since QtQuick.VirtualKeyboard 6.1] keyboardObserver : QVirtualKeyboardObserver* const
持有键盘观察者对象，该对象可用于接收键盘更改事件的通知。
该属性在 QtQuick.VirtualKeyboard 6.1 中引入。
访问函数：
| QVirtualKeyboardObserver * | keyboardObserver() const |
[read-only] locale : const QString
该属性用于保存本地语言。
当输入的本地语言发生变化时，该属性也会发生变化。
访问功能：
| QString | locale() const |
Notifier 信号：
| void | localeChanged() |
preeditText : QString
该属性保存编辑前文本。
该属性设置编辑前文本。
访问功能：
| QString | preeditText() const |
| void | setPreeditText(const QString &text, QList<QInputMethodEvent::Attribute> attributes = QList<QInputMethodEvent::Attribute>(), int replaceFrom = 0, int replaceLength = 0) |
通知信号：
| void | preeditTextChanged() |
[read-only] selectedText : const QString
该属性用于保存选中的文本。
当所选文本发生变化时，该属性也会发生变化。
访问功能：
| QString | selectedText() const |
通知信号：
| void | selectedTextChanged() |
[read-only] selectionControlVisible : const bool
如果选择控件当前可见，则保持true 。
访问功能：
| bool | isSelectionControlVisible() const |
通知信号：
| void | selectionControlVisibleChanged() |
[read-only] shiftActive : const bool
该属性用于保存轮班状态。
当轮班状态发生变化时，该属性也会发生变化。
访问功能：
| bool | isShiftActive() const |
通知信号：
| void | shiftActiveChanged() |
[read-only] surroundingText : const QString
该属性用于保存光标周围的文本。
当光标周围的文本发生变化时，该属性也会发生变化。
访问功能：
| QString | surroundingText() const |
通知信号：
| void | surroundingTextChanged() |
[read-only] uppercase : const bool
该属性表示大写状态。
当shiftActive 或capsLockActive 为true 时，该属性为true 。
访问功能：
| bool | isUppercase() const |
Notifier 信号：
| void | uppercaseChanged() |
成员函数 文档
[invokable] void QVirtualKeyboardInputContext::clear()
清除编辑前文本。
注： 可通过元对象系统和 QML 调用此功能。请参阅Q_INVOKABLE 。
[invokable] void QVirtualKeyboardInputContext::commit()
提交当前的预编辑文本。
注： 可通过元对象系统和 QML 调用此函数。请参阅Q_INVOKABLE 。
[invokable] void QVirtualKeyboardInputContext::commit(const QString &text, int replaceFrom = 0, int replaceLength = 0)
提交输入项的最终text ，并可选择修改相对于编辑前文本起始位置的文本。如果replaceFrom 非零，则text 会替换相对于replaceFrom 的内容，长度为replaceLength 。
注： 可通过元对象系统和 QML 调用此函数。请参见Q_INVOKABLE 。
[invokable] void QVirtualKeyboardInputContext::sendKeyClick(int key, const QString &text, int modifiers = 0)
使用给定的key 、text 和modifiers 向当前拥有焦点的输入项发送按键点击事件。
注： 可通过元对象系统和 QML 调用此函数。请参见Q_INVOKABLE 。
© 2025 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.
