InputEngine QML Type
ユーザー入力を入力メソッドにマッピングする。詳細...
| Import Statement: | import QtQuick.VirtualKeyboard |
| In C++: | QVirtualKeyboardInputEngine |
プロパティ
- activeKey : int
- inputMethod : InputMethod
- inputMode : int
- inputModes : list<int>
- patternRecognitionModes : list<int>
(since QtQuick.VirtualKeyboard 2.0) - previousKey : int
- wordCandidateListModel : SelectionListModel
- wordCandidateListVisibleHint : bool
シグナル
- void activeKeyChanged(int key)
- void inputMethodChanged()
- void inputMethodReset()
- void inputMethodUpdate()
- void inputModeChanged()
- void inputModesChanged()
- void patternRecognitionModesChanged()
(since QtQuick.VirtualKeyboard 2.0) - void previousKeyChanged(int key)
- void virtualKeyClicked(int key, string text, int modifiers)
メソッド
- Trace traceBegin(int traceId, int patternRecognitionMode, var traceCaptureDeviceInfo, var traceScreenInfo)
(since QtQuick.VirtualKeyboard 2.0) - bool traceEnd(Trace trace)
- void virtualKeyCancel()
- bool virtualKeyClick(int key, string text, int modifiers)
- bool virtualKeyPress(int key, string text, int modifiers, bool repeat)
- bool virtualKeyRelease(int key, string text, int modifiers)
詳細説明
入力エンジンは、入力イベントを入力メソッドにルーティングする。実際の入力ロジックは入力メソッドによって実装されます。
入力エンジンにはデフォルト入力メソッドも含まれており、アクティブな入力メソッドがイベントを処理できない場合のデフォルト処理を行います。
プロパティの説明
activeKey : int |
現在押されているキー。
inputMethod : InputMethod |
このプロパティを使用して、アクティブな入力メソッドを設定したり、アクティブな入力メソッドがいつ変更されるかを監視したりします。
inputMode : int |
現在の入力モードを取得または設定するには、このプロパティを使用します。InputEngine::inputModes プロパティは、現在の入力メソッドとロケールに対して有効な入力モードのリストを提供する。
定義済みの入力モードは以下のとおりです：
InputEngine.InputMode.Latinラテン文字のデフォルト入力モード。InputEngine.InputMode.Numeric数値入力のみが許可されます。InputEngine.InputMode.Dialableダイヤル入力のみ可能。InputEngine.InputMode.Pinyin中国語のピンイン入力モード。InputEngine.InputMode.Cangjie中国語の倉頡入力モード。InputEngine.InputMode.Zhuyin中国語のZhuyin入力モード。InputEngine.InputMode.Hangul韓国語のハングル入力モードInputEngine.InputMode.Hiragana日本語のひらがな入力モードInputEngine.InputMode.Katakana日本語のカタカナ入力モードInputEngine.InputMode.FullwidthLatin東アジア言語の全角ラテン文字入力モード。InputEngine.InputMode.Greekギリシャ語入力モードInputEngine.InputMode.Cyrillicキリル文字入力モード。InputEngine.InputMode.Arabicアラビア語入力モード。InputEngine.InputMode.Hebrewヘブライ語入力モード。InputEngine.InputMode.ChineseHandwriting中国語の手書き文字。InputEngine.InputMode.JapaneseHandwriting日本語手書きInputEngine.InputMode.KoreanHandwriting韓国語手書きInputEngine.InputMode.Thaiタイ語入力モードInputEngine.InputMode.Stroke中国語のストローク入力モード。InputEngine.InputMode.Romaji日本語のローマ字入力モード
利用可能な入力モードのリストは、入力メソッドとロケールに依存します。依存関係のいずれかが変更されると、このプロパティは更新されます。
利用可能なパターン認識モードのリスト。
指定可能な値：
| 定数 | 説明 |
|---|---|
InputEngine.PatternRecognitionMode.None | パターン認識は利用できません。 |
InputEngine.PatternRecognitionMode.PatternRecognitionDisabled | obsolete - 代わりに を使用してください。None |
InputEngine.PatternRecognitionMode.Handwriting | 手書き認識用のパターン認識モード。 |
InputEngine.PatternRecognitionMode.HandwritingRecoginition | obsolete - 代わりに を使用してください。Handwriting |
このプロパティは QtQuick.VirtualKeyboard 2.0 で導入されました。
previousKey : int |
以前に押されたキー。
wordCandidateListModel : SelectionListModel |
このプロパティを使用して、単語候補リストのリスト モデルにアクセスします。
wordCandidateListVisibleHint : bool |
このプロパティを使用して、単語候補リストを UI で表示するかどうかをチェックします。
シグナル ドキュメント
void activeKeyChanged(int key) |
アクティブなkey が変更されたことを示します。
注： 対応するハンドラはonActiveKeyChanged です。
void inputMethodChanged() |
入力メソッドが変更されたことを示す。
注 ：対応するハンドラはonInputMethodChanged 。
void inputMethodReset() |
入力メソッドをリセットする必要があるときに発せられる。
注 ：この信号は、入力メソッドがアクティブになると、自動的にQVirtualKeyboardAbstractInputMethod::reset() とInputMethod::reset() に接続される。
注： 対応するハンドラはonInputMethodReset 。
void inputMethodUpdate() |
注： このシグナルは、入力メソッドが起動すると自動的にQVirtualKeyboardAbstractInputMethod::update() とInputMethod::update() に接続される。
注 ：対応するハンドラはonInputMethodUpdate 。
void inputModeChanged() |
入力モードが変更されたことを示す。
注： 対応するハンドラはonInputModeChanged 。
void inputModesChanged() |
利用可能な入力モードが変更されたことを示す。
注： 対応するハンドラはonInputModesChanged です。
|
利用可能なパターン認識モードが変更されたことを示す。
定義済みのパターン認識モードは次のとおりです：
InputEngine.PatternRecognitionMode.Noneパターン認識は利用できません。InputEngine.PatternRecognitionMode.PatternRecognitionDisabledobsoleteInputEngine .PatternRecognitionMode.None を使用してください。InputEngine.PatternRecognitionMode.Handwriting手書き認識用のパターン認識モード。InputEngine.PatternRecognitionMode.HandwritingRecoginitionobsoleteInputEngine .PatternRecognitionMode.Handwriting を使用します。
注: 対応するハンドラはonPatternRecognitionModesChanged です。
このシグナルはQtQuick.VirtualKeyboard 2.0で導入されました。
void previousKeyChanged(int key) |
前のkey が変更されたことを示します。
注意 : 対応するハンドラはonPreviousKeyChanged です。
与えられたtext とmodifiers で仮想key がクリックされたことを示します。このシグナルは、入力メソッドがキーイベントを処理した後に発せられます。
注意 ：対応するハンドラはonVirtualKeyClicked です。
メソッドドキュメント
入力エンジンとトレースインタラクションを開始します。
トレースはtraceId によって一意に識別されます。 入力メソッドがイベントを受け入れると、入力エンジンはその id を Trace オブジェクトに割り当てます。
patternRecognitionMode は、パターンに使用される認識モードを指定します。
現在の入力メソッドがイベントを受け入れると、このインタラクションに関連付けられた Trace オブジェクトを返します。入力メソッドがイベントを破棄する場合、それは null 値を返す。
traceCaptureDeviceInfo はソースデバイスに関する情報を提供し、traceScreenInfo はスクリーンコンテキストに関する情報を提供する。
定義上、Traceオブジェクトは、traceEnd （）メソッドが呼び出されるまで有効である。
トレース・インタラクションは、InputEngine.traceEnd() メソッドを呼び出すことで終了します。
このメソッドは QtQuick.VirtualKeyboard 2.0 で導入されました。
入力エンジンとのトレースインタラクションを終了します。
trace オブジェクトは、この関数を呼び出した後、いつでも破棄することができます。
トレースインタラクションが受け入れられた場合、この関数は真を返します（つまり、タッチイベントは他のことに使用されるべきではありません）。
void virtualKeyCancel() |
キーイベントを発生させずに、アクティブキーの状態を戻します。このメソッドは、ユーザーが現在のキーを破棄し、キーの状態を復元する必要がある場合に便利です。
与えられたkey 、text 、modifiers のキークリックイベントを発する。キーイベントが入力エンジンに受け入れられた場合はtrue を返す。
与えられたtext とmodifiers で、key が押されたことを示すためにキーボード レイヤによって呼び出されます。
key はアクティブキー（ダウンキー）として設定されます。実際のキーイベントは、virtualKeyRelease() メソッドによってキーが離されたときにトリガーされます。キー押下イベントは、virtualKeyCancel() を呼び出すことで破棄できます。
キーが押されると、repeat がtrue の場合、キーリピート・タイマーも開始されます。
キーがこの入力エンジンに受け入れられた場合はtrue を返す。
virtualKeyCancel() およびvirtualKeyRelease()も参照 。
key でキーを解放します。イベントがリピーティング・タイマーによって生成されていない場合、このメソッドは入力メソッドのキー・イベントを発行します。text とmodifiers が入力メソッドに渡される。
キーが入力エンジンに受け入れられた場合はtrue を返します。
本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
