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

仮想キーボードの表示を要求します。プラットフォームが仮想キーボードを提供していない場合、可視性は false のままとなります。

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

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

エディタの入力方式クエリ属性に状態の変化が生じた際、プラットフォームの入力方式に通知するために、入力項目から呼び出されます。queries 関数を呼び出す際は、何が変更されたかを示すためにパラメータを使用する必要があります。これにより、各入力方式はQInputMethodQueryEvent を使用して、関心のある属性についてクエリを実行できるようになります。

特に、カーソル位置が変更されるたびに `update` を呼び出すことが重要です。これは、カーソル位置の変更によって、周囲のテキストやテキストの選択範囲といった他のクエリアトリビュートも変更されることが多いためです。カーソル位置とともに頻繁に変更される属性は、利便性のため `Qt::ImQueryInput ` の値にまとめられています。