QVirtualKeyboardInputContext 类

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

头文件	#include <QVirtualKeyboardInputContext>
CMake	find_package(Qt6 REQUIRED COMPONENTS VirtualKeyboard) target_link_libraries(mytarget PRIVATE Qt6::VirtualKeyboard)
qmake	QT += virtualkeyboard
由以下类实例化	InputContext
继承自	QObject

属性

anchorPosition : const int
anchorRectIntersectsClipRect : const bool
anchorRectangle : const QRectF
animating : bool
capsLockActive : const bool
cursorPosition : const int
cursorRectIntersectsClipRect : const bool
cursorRectangle : const QRectF
inputEngine : QVirtualKeyboardInputEngine* const

inputMethodHints : const Qt::InputMethodHints
(自 QtQuick.VirtualKeyboard 6.1) keyboardObserver : QVirtualKeyboardObserver* const
locale : const QString
preeditText : QString
selectedText : const QString
selectionControlVisible : const bool
shiftActive : const bool
surroundingText : const QString
uppercase : const bool

公共函数

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	光标位置() const
bool	光标矩形与裁剪矩形相交() const
QRectF	光标矩形() const
QVirtualKeyboardInputEngine *	输入引擎() const
Qt::InputMethodHints	输入法提示() const
bool	是否正在动画() const
bool	大写锁状态() const
bool	是否显示选择控制() const
bool	是否活动大小写() const
bool	是否大写() const
QVirtualKeyboardObserver *	键盘观察者() const
QString	区域设置() const
QString	预编辑文本() const
QString	所选文本() const
void	发送按键点击(int key, const QString &text, int modifiers = 0)
void	设置动画状态(bool isAnimating)
void	设置预编辑文本(const QString &text, QList<QInputMethodEvent::Attribute> attributes = QList<QInputMethodEvent::Attribute>(), int replaceFrom = 0, int replaceLength = 0)
QString	周围文本() 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()

详细描述

属性文档

`[只读]` anchorPosition : const int

此属性保存锚点位置。

当锚点位置更改时，此属性将发生更改。

访问函数

int	anchorPosition() const

通知信号

void	anchorPositionChanged()

`[只读]` anchorRectIntersectsClipRect : const bool

如果选择锚点的包围矩形与暴露的输入项矩形相交，则包含 true。

访问函数

bool	anchorRectIntersectsClipRect() const

通知信号

void	anchorRectIntersectsClipRectChanged()

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

`[只读]` anchorRectangle : const QRectF

此属性保存锚点矩形。

当锚点矩形更改时，此属性将发生更改。

访问函数

QRectF anchorRectangle() const

通知信号

void	anchorRectangleChanged()

animating : bool

此属性保存动画状态。

使用此属性设置动画状态，例如在UI过渡状态期间。

访问函数

bool	isAnimating() const
void	setAnimating(bool isAnimating)

通知信号

void	animatingChanged()

`[只读]` capsLockActive : const bool

此属性保存大写锁状态。

该属性在大写锁定状态改变时会被修改。

访问函数

bool	isCapsLockActive() const

通知信号

void	capsLockActiveChanged()

`[只读]` cursorPosition : const int

该属性保存光标位置。

该属性在光标位置改变时会更新。

访问函数

int	cursorPosition() const

通知信号

void	cursorPositionChanged()

`[只读]` cursorRectIntersectsClipRect : const bool

保存 true 如果输入光标的外接矩形与暴露的输入项矩形相交。

访问函数

bool	cursorRectIntersectsClipRect() const

通知信号

void	cursorRectIntersectsClipRectChanged()

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

`[只读]` cursorRectangle : const QRectF

该属性保存光标矩形。

该属性在光标矩形改变时会更新。

访问函数

QRectF cursorRectangle() const

通知信号

void	cursorRectangleChanged()

`[只读]` inputEngine : QVirtualKeyboardInputEngine* const

该属性保存输入引擎。

该属性存储输入引擎。

访问函数

QVirtualKeyboardInputEngine * inputEngine() const

`[只读]` inputMethodHints : const Qt::InputMethodHints

该属性保存输入法提示信息。

该属性在输入法提示信息改变时会更新。

访问函数

Qt::InputMethodHints inputMethodHints() const

通知信号

void	inputMethodHintsChanged()

`[只读，自 QtQuick.VirtualKeyboard 6.1]` keyboardObserver : QVirtualKeyboardObserver* const

保存键盘观察者对象，可用于接收键盘变更事件的通知。

该属性自 QtQuick.VirtualKeyboard 6.1 以来被引入。

访问函数

QVirtualKeyboardObserver * keyboardObserver() const

`[只读]` locale : const QString

该属性保存区域设置。

该属性在输入区域设置改变时会更新。

访问函数

QString locale() const

通知信号

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

`[只读]` selectedText : const QString

该属性保存选定的文本。

该属性在选定的文本改变时会更新。

访问函数

QString selectedText() const

通知信号

void	selectedTextChanged()

`[只读]` selectionControlVisible : const bool

保存 true 如果当前选区控制可见。

访问函数

bool	selectionControlVisible() const

通知信号

void	selectionControlVisibleChanged()

`[只读]` shiftActive : const bool

此属性保存变速状态。

当变速状态变化时，此属性会改变。

访问函数

bool	isShiftActive() const

通知信号

void	shiftActiveChanged()

`[只读]` surroundingText : const QString

此属性保存光标周围的文本。

当光标周围的文本改变时，此属性会改变。

访问函数

QString surroundingText() const

通知信号

void	surroundingTextChanged()

`[只读]` uppercase : const bool

此属性保存大写状态。

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

访问函数

bool	isUppercase() const

通知信号

void	uppercaseChanged()

成员函数文档

`[可调用]` void QVirtualKeyboardInputContext::clear()

清除预编辑文本。

注意：此函数可以通过元对象系统从 QML 调用。请参阅Q_INVOKABLE。

`[可调用]` void QVirtualKeyboardInputContext::commit()

提交当前预编辑文本。

注意：此函数可以通过元对象系统从 QML 调用。请参阅Q_INVOKABLE。

`[可调用]` void QVirtualKeyboardInputContext::commit(const QString &text, int replaceFrom = 0, int replaceLength = 0)

提交最终text到输入项，并且可选地修改预编辑文本的相对内容。如果replaceFrom不为零，则text替换相对replaceFrom的replaceLength长度的内容。

注意：此函数可以通过元对象系统从 QML 调用。请参阅Q_INVOKABLE。

`[可调用]` void QVirtualKeyboardInputContext::sendKeyClick(int key, const QString &text, int modifiers = 0)

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

注意：此函数可以通过元对象系统从 QML 调用。请参阅Q_INVOKABLE。

QVirtualKeyboardInputContext 类

属性

公共函数

信号

详细描述

属性文档

[只读] anchorPosition : const int

[只读] anchorRectIntersectsClipRect : const bool

[只读] anchorRectangle : const QRectF

animating : bool

[只读] capsLockActive : const bool

[只读] cursorPosition : const int

[只读] cursorRectIntersectsClipRect : const bool

[只读] cursorRectangle : const QRectF

[只读] inputEngine : QVirtualKeyboardInputEngine* const

[只读] inputMethodHints : const Qt::InputMethodHints

[只读，自 QtQuick.VirtualKeyboard 6.1] keyboardObserver : QVirtualKeyboardObserver* const

[只读] locale : const QString

preeditText : QString

[只读] selectedText : const QString

[只读] selectionControlVisible : const bool

[只读] shiftActive : const bool

[只读] surroundingText : const QString

[只读] uppercase : const bool

成员函数文档

[可调用] void QVirtualKeyboardInputContext::clear()

[可调用] void QVirtualKeyboardInputContext::commit()

[可调用] void QVirtualKeyboardInputContext::commit(const QString &text, int replaceFrom = 0, int replaceLength = 0)

[可调用] void QVirtualKeyboardInputContext::sendKeyClick(int key, const QString &text, int modifiers = 0)

`[只读]` anchorPosition : const int

`[只读]` anchorRectIntersectsClipRect : const bool

`[只读]` anchorRectangle : const QRectF

`[只读]` capsLockActive : const bool

`[只读]` cursorPosition : const int

`[只读]` cursorRectIntersectsClipRect : const bool

`[只读]` cursorRectangle : const QRectF

`[只读]` inputEngine : QVirtualKeyboardInputEngine* const

`[只读]` inputMethodHints : const Qt::InputMethodHints

`[只读，自 QtQuick.VirtualKeyboard 6.1]` keyboardObserver : QVirtualKeyboardObserver* const

`[只读]` locale : const QString

`[只读]` selectedText : const QString

`[只读]` selectionControlVisible : const bool

`[只读]` shiftActive : const bool

`[只读]` surroundingText : const QString

`[只读]` uppercase : const bool

`[可调用]` void QVirtualKeyboardInputContext::clear()

`[可调用]` void QVirtualKeyboardInputContext::commit()

`[可调用]` void QVirtualKeyboardInputContext::commit(const QString &text, int replaceFrom = 0, int replaceLength = 0)

`[可调用]` void QVirtualKeyboardInputContext::sendKeyClick(int key, const QString &text, int modifiers = 0)