InputMethod QML Type
QMLで入力メソッドを作成するための基本型。詳細...
Import Statement: | import QtQuick.VirtualKeyboard |
プロパティ
- inputContext : InputContext
- inputEngine : InputEngine
信号
- selectionListActiveItemChanged(int type, int index)
- selectionListChanged(int type)
- selectionListsChanged()
(since QtQuick.VirtualKeyboard 2.2)
方法
- bool clickPreeditText(int cursorPosition)
(since QtQuick.VirtualKeyboard 2.4)
- list<int> inputModes(string locale)
- bool keyEvent(int key, string text, int modifiers)
- list<int> patternRecognitionModes()
(since QtQuick.VirtualKeyboard 2.0)
- bool reselect(int cursorPosition, int reselectFlags)
(since QtQuick.VirtualKeyboard 2.0)
- reset()
- var selectionListData(int type, int index, int role)
- int selectionListItemCount(int type)
- void selectionListItemSelected(int type, int index)
- list<int> selectionLists()
- bool setInputMode(string locale, int inputMode)
- bool setTextCase(int textCase)
- Trace traceBegin(int traceId, int patternRecognitionMode, var traceCaptureDeviceInfo, var traceScreenInfo)
(since QtQuick.VirtualKeyboard 2.0)
- bool traceEnd(Trace trace)
(since QtQuick.VirtualKeyboard 2.0)
- update()
詳細説明
InputMethod型を使用すると、InputEngine に割り当てることができるカスタム入力メソッドを作成できます。
プロパティの説明
inputContext : InputContext |
入力コンテキスト。
inputEngine : InputEngine |
入力エンジン。
シグナル・ドキュメント
入力メソッドは、type で識別される選択リストで現在のindex が変更されたときに、このシグナルを発信します。
注: 対応するハンドラはonSelectionListActiveItemChanged
です。
selectionListChanged(int type) |
入力メソッドは、選択リストの内容が変更されたときにこのシグナルを発する。type パラメータは、どの選択リストが変更されたかを指定する。
注: 対応するハンドラはonSelectionListChanged
です。
|
選択リストの型が変更されると、inputメソッドはこのシグナルを発する。このシグナルがトリガーとなってselectionLists() メソッドが呼び出され、入力メソッドが選択リストの型を更新できるようになります。
注意: 対応するハンドラはonSelectionListsChanged
です。
このシグナルは QtQuick.VirtualKeyboard 2.2 で導入されました。
メソッドのドキュメント
cursorPosition の編集前テキストをユーザーがクリックしたときに呼び出される。
この関数は、イベントを処理した場合はtrue
を返す。そうでない場合、入力はreselect() に戻り、さらに処理されます。
このメソッドは QtQuick.VirtualKeyboard 2.4 で導入されました。
このメソッドの目的は、入力エンジンによって生成されたキーイベントを処理することです。
key パラメータは、処理するキーのコードを指定します。キーコードは、大文字と小文字を区別しません。text パラメーターには、キーの Unicode テキストを指定します。modifiers パラメータには、key に適用されるキー修飾子が含まれます。
このメソッドは、キー・イベントが正常に処理された場合はtrue
を返す。戻り値がfalse
の場合、キー・イベントはデフォルトの入力メソッドにリダイレクトされます。
サポートされているパターン認識モードのリストを返す。
このメソッドは入力エンジンによって呼び出され、サポートされているパターン認識モードのリストを照会します。
このメソッドは QtQuick.VirtualKeyboard 2.0 で導入されました。
このメソッドは、cursorPosition に位置する単語の再選択を試みます。reselectFlags は、カーソル位置に対して単語がどのように選択されるべきかのルールを定義しています。
InputEngine.WordBeforeCursor
カーソルの前にある単語をアクティブにする。このフラグのみが使用される場合、単語はカーソル位置で正確に終了しなければならない。InputEngine.WordAfterCursor
カーソルの後の単語をアクティブにする。このフラグが排他的に使用される場合、単語はカーソルで正確に開始されなければならない。InputEngine.WordAtCursor
カーソル位置で単語をアクティブにする。このフラグは上記のフラグを組み合わせたもので、例外として、単語はカーソルで始まったり止まったりすることはできない。
このメソッドは、単語の再選択に成功した場合、true
を返します。
このメソッドは QtQuick.VirtualKeyboard 2.0 で導入されました。
reset() |
このメソッドは、この入力メソッドをリセットする必要があるときに入力エンジンによって呼び出されます。入力メソッドはその内部状態のみをリセットする必要があります。update() メソッドとの主な違いは、reset() は入力メソッドの状態のみを変更することです。
type で識別される選択リストの項目データを返します。role パラメータは、要求するデータを指定します。index パラメータは、選択リストへのゼロ・ベースのインデックスです。
このメソッドは、index の項目がユーザによって選択されたときに呼び出されます。選択リストはtype パラメータで識別されます。
この入力メソッドで使用される選択タイプのリストを返します。
このメソッドは、入力メソッドがアクティブになったときと、入力メソッドのヒントが更新されるたびに入力エンジンから呼び出されます。入力メソッドは、希望する選択リストの型を返すことで、選択リストを予約することができる。
入力メソッドは、selectionListsChanged() シグナルを発することで、いつでも入力エンジンに選択リストの更新を要求することができる。このシグナルによってこのメソッドが呼び出され、入力メソッドが選択リストの型を更新できるようになります。
この入力メソッドのinputMode とlocale を変更する。このメソッドは成功するとtrue
を返す。
この入力メソッドのtextCase を更新する。このメソッドは、成功するとtrue
を返します。
テキスト・ケースに指定できる値は以下のとおりです:
InputEngine.Lower
小文字のテキスト。InputEngine.Upper
大文字テキスト。
このメソッドは、指定されたpatternRecognitionMode でトレースインタラクションが開始されると呼び出される。トレースはtraceId によって一意に識別される。traceCaptureDeviceInfo はソースデバイスに関する情報を提供し、traceScreenInfo はスクリーンコンテキストに関する情報を提供する。
input メソッドがイベントを受け入れ、トレース入力をキャプチャしたい場合、新しい Trace オブジェクトを返さなければなりません。このオブジェクトは、InputMethod.traceEnd ()メソッドが呼び出されるまで有効でなければならない。Trace がスクリーン上にレンダリングされた場合、Trace オブジェクトが破棄されるまで、Trace はスクリーン上に残ります。
このメソッドは QtQuick.VirtualKeyboard 2.0 で導入されました。
このメソッドは、トレース・インタラクションが終了したときに呼び出される。入力メソッドは、この関数が呼ばれた後のある時点でtrace オブジェクトを破棄する必要があります。成功するとtrue
を返します。
収集されたデータにアクセスする方法は、トレース API for Input Methodsを参照してください。
このメソッドは QtQuick.VirtualKeyboard 2.0 で導入されました。
update() |
このメソッドは、入力メソッドを更新する必要があるときに入力エンジンから呼び出されます。入力メソッドは、現在の編集前のテキストを閉じ、内部状態をデフォルトに戻す必要があります。
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.