InputContext QML Type

提供对输入上下文的访问。更多

Import Statement:	`import QtQuick.VirtualKeyboard`
In C++:	QVirtualKeyboardInputContext

属性

anchorPosition : int (since QtQuick.VirtualKeyboard 2.2)
anchorRectIntersectsClipRect : bool
anchorRectangle : rect (since QtQuick.VirtualKeyboard 2.1)
animating : bool
capsLockActive : bool (since QtQuick.VirtualKeyboard 2.4)
cursorPosition : int
cursorRectIntersectsClipRect : bool
cursorRectangle : rect
inputEngine : InputEngine
inputMethodHints : int
keyboardObserver : KeyboardObserver (since QtQuick.VirtualKeyboard 6.1)
locale : string
preeditText : string
selectedText : string
selectionControlVisible : bool
shiftActive : bool (since QtQuick.VirtualKeyboard 2.4)
surroundingText : string
uppercase : bool (since QtQuick.VirtualKeyboard 2.2)

方法

void clear()
void commit()
void commit(string text, int replaceFrom, int replaceLength)
void sendKeyClick(int key, string text, int modifiers)

详细说明

InputContext 可作为单例访问。

属性文档

anchorPosition : int [read-only, since QtQuick.VirtualKeyboard 2.2]

该属性在锚点位置改变时改变。

该属性在 QtQuick.VirtualKeyboard 2.2 中引入。

anchorRectIntersectsClipRect : bool [read-only]

如果选择锚的边界矩形与暴露的输入项矩形相交，则保持true 。

另请参阅 Qt::ImAnchorRectangle 和Qt::ImInputItemClipRectangle 。

anchorRectangle : rect [read-only, since QtQuick.VirtualKeyboard 2.1]

该属性在锚点矩形改变时改变。

该属性在 QtQuick.VirtualKeyboard 2.1 中引入。

animating : bool

使用该属性可设置动画状态，例如在 UI 过渡状态时。

capsLockActive : bool [read-only, since QtQuick.VirtualKeyboard 2.4]

当大写锁定状态改变时，该属性也会改变。

该属性在 QtQuick.VirtualKeyboard 2.4 中引入。

cursorPosition : int [read-only]

当光标位置发生变化时，该属性也会发生变化。

cursorRectIntersectsClipRect : bool [read-only]

如果输入光标的边界矩形与暴露的输入项矩形相交，则保持true 。

另请参阅 Qt::ImCursorRectangle 和Qt::ImInputItemClipRectangle 。

cursorRectangle : rect [read-only]

当光标矩形发生变化时，该属性也会发生变化。

inputEngine : InputEngine [read-only]

该属性存储输入引擎。

inputMethodHints : int [read-only]

当输入法提示发生变化时，该属性也会发生变化。

keyboardObserver : KeyboardObserver [read-only, since QtQuick.VirtualKeyboard 6.1]

持有键盘观察者对象，该对象可用于接收键盘变化事件的通知。

该属性在 QtQuick.VirtualKeyboard 6.1 中引入。

locale : string [read-only]

当输入语言发生变化时，该属性也会发生变化。

preeditText : string

该属性设置预编辑文本。

selectedText : string [read-only]

当所选文本发生变化时，该属性发生变化。

selectionControlVisible : bool [read-only]

如果选择控件当前可见，则保持true 。

shiftActive : bool [read-only, since QtQuick.VirtualKeyboard 2.4]

当移位状态改变时，该属性改变。

该属性在 QtQuick.VirtualKeyboard 2.4 中引入。

surroundingText : string [read-only]

当光标周围的文本发生变化时，该属性发生变化。

uppercase : bool [read-only, since QtQuick.VirtualKeyboard 2.2]

当shiftActive 或capsLockActive 为true 时，该属性为true 。

该属性在QtQuick.VirtualKeyboard 2.2中引入。

方法文档

void clear()

清除预编辑文本。

void commit()

提交当前预编辑文本。

void commit(string text, int replaceFrom = 0, int replaceLength = 0)

提交最终text 到输入项，并可选择相对于预编辑文本的起始位置修改文本。如果replaceFrom非零，text 就会以replaceLength 的长度替换相对于replaceFrom 的内容。

void sendKeyClick(int key, string text, int modifiers = 0)

使用给定的key 、text 和modifiers 向当前拥有焦点的输入项发送按键点击事件。

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