QInputMethod Class

成员函数文档

[slot] void QInputMethod::commit()

将用户正在输入的单词提交到编辑器。具有文本预测功能的输入法以及输入字符时使用的脚本与实际添加到编辑器中的脚本不同的输入法大多需要该函数。任何中断文字合成的操作都需要通过调用 commit() 函数来清除合成状态，例如当光标移动到其他地方时。

[slot] void QInputMethod::hide()

请求关闭虚拟键盘。

通常情况下，应用程序不需要调用此函数，因为当文本编辑器失去焦点时（例如父视图关闭时），键盘应自动关闭。

QRectF QInputMethod::inputItemRectangle() const

以输入项坐标为单位返回输入项的几何图形。

另请参阅 setInputItemRectangle()。

QTransform QInputMethod::inputItemTransform() const

返回从输入项目坐标到窗口坐标的变换。

另请参阅 setInputItemTransform()。

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

当用户点击当前正在组成的单词（如操作a 和给定的cursorPosition 所示）时，由输入项调用。输入法通常会利用这一信息向用户提供更多的单词建议。

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

向当前焦点对象发送query ，参数argument ，并返回结果。

[slot] void QInputMethod::reset()

重置输入法状态。例如，文本编辑器通常会在插入文本前调用此方法，使部件准备好接受文本。

当聚焦的编辑器发生变化时，输入法会自动重置。

void QInputMethod::setInputItemRectangle(const QRectF &rect)

以输入项坐标设置输入项的几何图形为rect 。每当项目在场景中移动或焦点改变时，焦点窗口（如 QQuickCanvas）都需要更新该几何图形。

另请参阅 inputItemRectangle().

void QInputMethod::setInputItemTransform(const QTransform &transform)

将输入项目坐标到窗口坐标的变换设置为transform 。每当项目在场景中移动时，项目变换需要像 QQuickCanvas 一样由聚焦窗口更新。

另请参阅 inputItemTransform() 。

void QInputMethod::setVisible(bool visible)

控制键盘的可见性。相当于调用show() （如果visible 是true ）或hide() （如果visible 是false ）。

另请参阅 isVisible()、show() 和hide()。

[slot] void QInputMethod::show()

请求打开虚拟键盘。如果平台不提供虚拟键盘，则可见性仍为 false。

通常情况下，应用程序不需要调用此函数，键盘应在文本编辑器获得焦点时自动打开。

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

当编辑器的输入法查询属性发生状态变化时，由输入项调用以通知平台输入法。调用该函数时，必须使用queries 参数来说明发生了哪些变化，输入法可以使用QInputMethodQueryEvent 对其感兴趣的属性进行查询。

尤其是在光标位置发生变化时调用 update 非常重要，因为这通常会导致其他查询属性（如周围文本和文本选择）也发生变化。为方便起见，经常与光标位置一起变化的属性已在Qt::ImQueryInput 值中分组。