InputMethod QML Type

QMLで入力メソッドを作成するための基本型。詳細...

Import Statement: import QtQuick.VirtualKeyboard

プロパティ

シグナル

メソッド

詳細説明

InputMethod タイプを使用すると、InputEngine に割り当てることができるカスタム入力メソッドを作成できます。

プロパティの説明

inputContext : InputContext [read-only]

入力コンテキスト。


inputEngine : InputEngine [read-only]

入力エンジン。


シグナル・ドキュメント

selectionListActiveItemChanged(int type, int index)

入力メソッドは、type で識別される選択リストで現在のindex が変更されたときに、このシグナルを発信します。

注: 対応するハンドラはonSelectionListActiveItemChanged です。


selectionListChanged(int type)

入力メソッドは、選択リストの内容が変更されたときにこのシグナルを発する。type パラメータは、どの選択リストが変更されたかを指定する。

注: 対応するハンドラはonSelectionListChanged です。


[since QtQuick.VirtualKeyboard 2.2] selectionListsChanged()

入力メソッドは、選択リストの型が変更されるとこのシグナルを発する。このシグナルをトリガーにselectionLists() メソッドが呼び出され、入力メソッドが選択リストの型を更新できるようになります。

注意: 対応するハンドラはonSelectionListsChanged です。

このシグナルは QtQuick.VirtualKeyboard 2.2 で導入されました。


メソッドの説明

[since QtQuick.VirtualKeyboard 2.4] bool clickPreeditText(int cursorPosition)

cursorPosition で、ユーザーが編集前のテキストをクリックしたときに呼び出されます。

この関数は、イベントを処理した場合はtrue を返します。そうでない場合、入力はreselect() に戻り、さらに処理されます。

このメソッドは QtQuick.VirtualKeyboard 2.4 で導入されました。


list<int> inputModes(string locale)

locale の入力モードのリストを返します。


bool keyEvent(int key, string text, int modifiers)

このメソッドの目的は、入力エンジンによって生成されたキーイベントを処理することです。

key パラメータは、処理するキーのコードを指定します。キーコードは、大文字と小文字を区別しません。text パラメーターには、キーの Unicode テキストを指定します。modifiers パラメータには、key に適用されるキー修飾子が含まれます。

このメソッドは、キー・イベントが正常に処理された場合はtrue を返す。戻り値がfalse の場合、キー・イベントはさらなる処理のためにデフォルトの入力メソッドにリダイレクトされます。


[since QtQuick.VirtualKeyboard 2.0] list<int> patternRecognitionModes()

サポートされるパターン認識モードのリストを返す。

このメソッドは、サポートされているパターン認識モードのリストを問い合わせるために、入力エンジンによって呼び出されます。

このメソッドは QtQuick.VirtualKeyboard 2.0 で導入されました。


[since QtQuick.VirtualKeyboard 2.0] bool reselect(int cursorPosition, int reselectFlags)

このメソッドは、cursorPosition にある単語の再選択を試みます。reselectFlags は、カーソル位置に対して単語をどのように選択するかのルールを定義します。

  • InputEngine.WordBeforeCursor カーソルの前にある単語をアクティブにする。このフラグのみが使用される場合、単語はカーソル位置で正確に終了しなければならない。
  • InputEngine.WordAfterCursor カーソルの後の単語をアクティブにする。このフラグが排他的に使用される場合、単語はカーソルで正確に開始されなければならない。
  • InputEngine.WordAtCursor 単語をカーソルでアクティブにする。このフラグは上記のフラグを組み合わせたもので、例外として、単語はカーソルで始まったり止まったりすることはできない。

このメソッドは、単語の再選択に成功した場合、true を返します。

このメソッドは QtQuick.VirtualKeyboard 2.0 で導入されました。


reset()

このメソッドは、この入力メソッドをリセットする必要があるときに入力エンジンによって呼び出されます。入力メソッドは、その内部状態のみをリセットする必要があります。update() メソッドとの主な違いは、reset() は入力メソッドの状態のみを変更することです。


var selectionListData(int type, int index, int role)

type で識別される選択リストの項目データを返します。role パラメータは、要求するデータを指定します。index パラメータは、選択リストへのゼロ・ベースのインデックスです。


int selectionListItemCount(int type)

type で識別される選択リストの項目数を返します。


void selectionListItemSelected(int type, int index)

このメソッドは、index の項目がユーザによって選択されたときに呼び出されます。選択リストはtype パラメータで識別されます。


list<int> selectionLists()

この入力メソッドで使用される選択タイプのリストを返します。

このメソッドは、入力メソッドがアクティブになったときと、入力メソッドのヒントが更新されるたびに入力エンジンから呼び出されます。入力メソッドは、希望する選択リストの型を返すことで、選択リストを予約することができる。

入力メソッドは、selectionListsChanged() シグナルを発することで、いつでも入力エンジンに選択リストの更新を要求することができる。このシグナルによってこのメソッドが呼び出され、入力メソッドが選択リストの型を更新できるようになります。


bool setInputMode(string locale, int inputMode)

この入力メソッドのinputModelocale を変更する。このメソッドは成功するとtrue を返す。


bool setTextCase(int textCase)

この入力メソッドのtextCase を更新する。成功すると、このメソッドはtrue を返します。

テキスト・ケースに指定できる値は以下のとおりです:

  • InputEngine.Lower 小文字のテキスト。
  • InputEngine.Upper 大文字テキスト。

[since QtQuick.VirtualKeyboard 2.0] Trace traceBegin(int traceId, int patternRecognitionMode, var traceCaptureDeviceInfo, var traceScreenInfo)

このメソッドは、指定されたpatternRecognitionMode でトレース・インタラクションが開始すると呼び出される。トレースは、traceId によって一意に識別されます。traceCaptureDeviceInfo はソース・デバイスに関する情報を提供し、traceScreenInfo はスクリーン・コンテキストに関する情報を提供します。

input メソッドがイベントを受け入れ、トレース入力をキャプチャしたい場合、新しい Trace オブジェクトを返さなければなりません。このオブジェクトは、InputMethod.traceEnd ()メソッドが呼び出されるまで有効でなければならない。Trace がスクリーン上にレンダリングされた場合、Trace オブジェクトが破棄されるまで、Trace はスクリーン上に残ります。

このメソッドは QtQuick.VirtualKeyboard 2.0 で導入されました。


[since QtQuick.VirtualKeyboard 2.0] bool traceEnd(Trace trace)

このメソッドは、Trace インタラクションが終了したときに呼び出されます。入力メソッドは、この関数が呼ばれた後のある時点でtrace オブジェクトを破棄する必要があります。成功するとtrue を返します。

収集されたデータにアクセスする方法は、トレース API for Input Methodsを参照してください。

このメソッドは QtQuick.VirtualKeyboard 2.0 で導入されました。


update()

このメソッドは、入力メソッドを更新する必要があるときに入力エンジンから呼び出されます。入力メソッドは、現在の編集前のテキストを閉じ、内部状態をデフォルトに戻す必要があります。


このドキュメントに含まれるコントリビューションの著作権は、それぞれの所有者に帰属します 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。