QInputMethod类

成员函数文档

<代码详情 extra>

void QInputMethod::commit()

将用户正在编写的单词提交给编辑器。该函数主要用于具有文本预测功能的输入方法和键位脚本不同于实际附加到编辑器的脚本的输入方法。任何中断文本编写的操作都需要通过调用commit()函数刷新编写状态，例如当光标被移动到其他地方时。

<代码详情 extra>

void QInputMethod::hide()

请求虚拟键盘关闭。

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

QRectF QInputMethod::inputItemRectangle() const

返回输入项在输入项坐标系中的几何形状。

另请参阅 setInputItemRectangle().

QTransform QInputMethod::inputItemTransform() const

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

另请参阅 setInputItemTransform().

<代码详情 extra>

void QInputMethod::invokeAction(QInputMethod::Action a, int cursorPosition)

当用户按下的动作a和给定的游标位置cursorPosition时，输入项会被调用。输入方法通常使用此信息向用户提供更多单词建议。

<代码详情 extra>

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

将查询query发送到当前焦点对象，并带参数argument，然后返回结果。

<代码详情 extra>

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 值中以便使用。