InputEngine QML Type

ユーザー入力を入力メソッドにマッピングする。詳細...

• 継承されたメンバーを含む全メンバーのリスト

プロパティ

• 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 [read-only]

現在押されているキー。

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.InputMode.HiraganaFlick 日本語のフリック入力モード

inputModes : list<int> [read-only]

使用可能な入力モードのリストは、入力メソッドとロケールに依存する。このプロパティは、どちらかの依存関係が変更されると更新されます。

patternRecognitionModes : list<int> [read-only, since QtQuick.VirtualKeyboard 2.0]

利用可能なパターン認識モードのリスト。

可能な値：

このプロパティは QtQuick.VirtualKeyboard 2.0 で導入されました。

previousKey : int [read-only]

以前押されたキー。

wordCandidateListModel : SelectionListModel [read-only]

このプロパティを使用して、単語候補リストのリスト・モデルにアクセスします。

wordCandidateListVisibleHint : bool [read-only]

このプロパティを使用して、単語候補リストをUIに表示するかどうかをチェックします。

シグナル・ドキュメント

void activeKeyChanged(int key)

アクティブなkey が変更されたことを示す。

void inputMethodChanged()

入力メソッドが変更されたことを示す。

void inputMethodReset()

入力方式をリセットする必要がある場合に発せられる。

void inputMethodUpdate()

void inputModeChanged()

入力モードが変更されたことを示す。

void inputModesChanged()

利用可能な入力モードが変更されたことを示す。

[since QtQuick.VirtualKeyboard 2.0] void patternRecognitionModesChanged()

利用可能なパターン認識モードが変更されたことを示します。

定義済みのパターン認識モードは次のとおりです：

• InputEngine.PatternRecognitionMode.None パターン認識は利用できません。
• InputEngine.PatternRecognitionMode.PatternRecognitionDisabled obsolete InputEngine .PatternRecognitionMode.None を使用してください。
• InputEngine.PatternRecognitionMode.Handwriting 手書き認識用のパターン認識モード。
• InputEngine.PatternRecognitionMode.HandwritingRecoginition obsolete InputEngine .PatternRecognitionMode.Handwriting を使用します。

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

void previousKeyChanged(int key)

前のkey が変更されたことを示す。

void virtualKeyClicked(int key, string text, int modifiers)

仮想のkey が、与えられたtext とmodifiers でクリックされたことを示します。このシグナルは、入力メソッドがキーイベントを処理した後に発行されます。

メソッド・ドキュメント

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

入力エンジンとトレースインタラクションを開始します。

トレースはtraceId で一意に識別されます。 入力メソッドがイベントを受け入れると、入力エンジンはその id を Trace オブジェクトに割り当てます。

patternRecognitionMode は、パターンに使用される認識モードを指定します。

現在の入力メソッドがイベントを受け入れると、このインタラクションに関連付けられた Trace オブジェクトを返します。入力メソッドがイベントを破棄する場合、NULL 値を返します。

traceCaptureDeviceInfo はソースデバイスに関する情報を提供し、traceScreenInfo はスクリーンコンテキストに関する情報を提供する。

定義上、Traceオブジェクトは、traceEnd （）メソッドが呼び出されるまで有効である。

トレース・インタラクションは、InputEngine.traceEnd() メソッドを呼び出すことで終了します。

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

bool traceEnd(Trace trace)

入力エンジンとのトレース・インタラクションを終了する。

trace オブジェクトは、この関数を呼び出した後、いつでも破棄することができる。

トレースインタラクションが受け入れられた場合、この関数はtrueを返します（つまり、タッチイベントは他のことに使用されるべきではありません）。

void virtualKeyCancel()

キー・イベントを発生させずに、アクティブなキーの状態を戻す。このメソッドは、ユーザーが現在のキーを破棄し、キー状態を復元する必要がある場合に便利です。

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

与えられたkey 、text 、modifiers のキークリックイベントを発する。キーイベントが入力エンジンに受け入れられた場合はtrue を返します。

bool virtualKeyPress(int key, string text, int modifiers, bool repeat)

与えられたtext とmodifiers で、key が押されたことを示すためにキーボードレイヤーによって呼び出される。

key はアクティブキー（ダウンキー）として設定される。実際のキー・イベントは、virtualKeyRelease() メソッドによってキーが離されたときにトリガーされます。キー押下イベントは、virtualKeyCancel() を呼び出すことで破棄できます。

キーが押されると、repeat がtrue の場合、キーリピート・タイマーも開始されます。

キーがこの入力エンジンに受け入れられた場合はtrue を返す。

virtualKeyCancel() およびvirtualKeyRelease()も参照してください 。

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

key でキーを解放する。イベントがリピーター・タイマーによって生成されていない場合、このメソッドは入力メソッドのキー・イベントを発行する。text とmodifiers が入力メソッドに渡される。

キーが入力エンジンに受け入れられた場合はtrue を返す。