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 的值中。