Qt5.3文档翻译：QInputMethod类，QInputMethod Class

常量	值	说明
QInputMethod::Click	0	一次普通的点击/触摸
QInputMethod::ContextMenu	1	一次用于触发上下文菜单的点击/触摸(例如：右键或者触摸并按住)

参考 invokeAction () 。

属性文档

animating : const bool

当虚拟键盘正在被打开或正在被关闭时，此属性为真（true）。

当键盘已经完整地打开或关闭之后，此属性为假（false）。当 animating 为真（ true ）并且 visibility 为真（ true ）则键盘正在被打开。当 animating 为真（ true ）并且 visibility 为假（ false ）则键盘正在被关闭。

访问函数：

bool	isAnimating() const

通知信号：

void	animatingChanged()

cursorRectangle : const QRectF

这个属性，以窗口坐标的形式表示当前输入项的光标矩形。

光标矩形经常被各种文本编辑控件使用，例如文本预测的弹出框可利用该属性来跟随当前输入位置。

访问函数：

QRectF

cursorRectangle() const

通知信号：

void	cursorRectangleChanged()

inputDirection : const Qt::LayoutDirection

此属性表示当前的输入方向。

访问函数：

Qt::LayoutDirection

inputDirection() const

通知信号：

void	inputDirectionChanged(Qt::LayoutDirection newDirection)

keyboardRectangle : const QRectF

此属性以窗口坐标的形式表示虚拟键盘的几何属性。

访问函数：

QRectF

keyboardRectangle() const

通知信号：

void	keyboardRectangleChanged()

locale : const QLocale

此属性表示当前的输入语言。

访问函数：

QLocale

locale() const

通知信号：

void	localeChanged()

visible : const bool

此属性表示虚拟键盘在屏幕上的可见性。

对于不带虚拟键盘的设备，输入法的可见性会保持为假（false）。

访问函数：

bool	isVisible() const

通知信号：

void	visibleChanged()

参考 show () 和 hide () 。

成员函数文档

void QInputMethod:: commit () [slot]

将用户当前正在编辑的单词提交给编辑器。此函数主要被这些东西用到：带有文本预测功能的输入法；以及，用户键入的内容与实际追加到编辑器中去的内容不同的输入法。任何一种会中断文字编辑过程的动作，都需要调用commit()函数来立即刷新编辑状态，例如，当光标被移动到别处的时候。

void QInputMethod:: hide () [slot]

请求关闭虚拟键盘。

一般情况下，应用程序应当不需要调用这个函数，键盘应当会在文本编辑器失去焦点时自动关闭，例如当其亲代视图被关闭时，编辑器会推动焦点。

QRectF QInputMethod:: inputItemRectangle () const

返回输入项在输入项自身坐标系里的几何属性。

此函数是从Qt 5.1开始引入的。

参考 setInputItemRectangle () 。

QTransform QInputMethod:: inputItemTransform () const

返回从输入项坐标系到窗口坐标系之间的变换对象。

参考 setInputItemTransform () 。

void QInputMethod:: invokeAction ( Action a , int cursorPosition ) [slot]

当那个当前正在被编辑的单词被用户点击时，会由输入项调用此函数，其参数包括：动作 a 和指定的光标位置（ cursorPosition ）。输入法通常使用这些信息来向用户提供更多的单词建议。

QVariant QInputMethod:: queryFocusObject ( Qt::InputMethodQuery query , QVariant argument ) [static]

向当前拥有焦点的对象发送一个请求（ query ），其参数为 argument ，并且返回其结果。

void QInputMethod:: reset () [slot]

重置输入法的状态。例如，文本编辑器一般会在插入文字之前调用这个方法，以使得部件作好接收文字的准备。

当拥有焦点的编辑器发生改变时，输入法会自动重置。

void QInputMethod:: setInputItemRectangle (const QRectF & rect )

以输入项本身的坐标系坐标来将输入项的几何属性设置为 rect 。拥有焦点的窗口（例如QQuickCanvas）需要在以下情况下更新此属性：某个条目在场景中移动了；或者，焦点发生变化。

此函数是从Qt 5.1开始引入的。

参考 inputItemRectangle () 。

void QInputMethod:: setInputItemTransform (const QTransform & transform )

将输入项坐标第到窗口坐标系之间的变换设置为 transform 。拥有焦点的窗口（例如QQuickCanvas）需要在以下情况下更新输入项的变换对象：某个条目在场景中移动了。

参考 inputItemTransform () 。

void QInputMethod::setVisible(bool visible)

控制键盘的可见性。等价于调用 show ()(此时 visible 为真（ true ） ) 或 hide ()(此时 visible 为假（ false ） ) 。

参考 isVisible () 、 show () 和 hide () 。

void QInputMethod:: show () [slot]

请求打开虚拟键盘。如果当前平台不提供虚拟键盘，则可见性保持为假（false）。

一般情况下，应用程序应当不需要调用这个函数，当文本编辑器获取到焦点时，键盘会自动打开。

void QInputMethod:: update ( Qt::InputMethodQueries queries ) [slot]

由输入项来调用，告知系统中的输入法：编辑器的输入法查询属性中发生了某些状态改变。在调用这个函数的时候，要使用 queries 参数来告知究竟有哪些东西发生了改变，日后，输入法就可以用这个参数来通过 QInputMethodQueryEvent 查询到它自己感兴趣的属性。

尤其狠重要的一点是，当光标位置发生变化时，需要调用更新函数（update），因为这种变化通常会引起其它的查询属性（例如周围文字及文字选中范围）发生变化。那些常随着光标位置的变化而发生变化的属性，已经收集到 Qt::ImQueryInput 值中，以便于使用。

Your opinions

Your name:

Email:Website url:Opinion content: