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)

現在のフォーカス・オブジェクトにパラメータargument でquery を送り、結果を返す。

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

仮想キーボードを開くように要求する。プラットフォームが仮想キーボードを提供していない場合、visibilityはfalseのままです。

通常、アプリケーションはこの関数を呼び出す必要はなく、テキストエディタがフォーカスを得たときに自動的にキーボードが開くはずです。

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

エディターの入力メソッドのクエリ属性に状態変化があったときに、プラットフォームの入力メソッドに通知するために入力アイテムによって呼び出されます。この関数を呼び出す際には、queries パラメータを使用して、何が変更されたかを伝える必要があります。このパラメータを使用して、入力メソッドはQInputMethodQueryEvent で興味のある属性のクエリを作成することができます。

特に、カーソルの位置が変わるたびにupdateを呼び出すことは重要です。カーソルの位置が変わると、周囲のテキストやテキスト選択などの他のクエリー属性も変わることがよくあるからです。カーソル位置と一緒に変化することが多い属性は、便宜上Qt::ImQueryInput 。