InputContext QML Type (Singleton)

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

注意：该类型是 QML 单例。在 QML 引擎中该类型只有一个实例。

• 所有成员（包括继承成员）列表
• 已废弃成员

属性

• 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 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 6.1]

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

该属性在 Qt 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 会替换相对于replaceFrom 的内容，替换长度为replaceLength。

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

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