Back to Qt.io
Contact Us Blog Download Qt

InputEngine QML Type

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

Import Statement: import QtQuick.VirtualKeyboard
In C++: QVirtualKeyboardInputEngine

プロパティ

信号

方法

詳細説明

入力エンジンは、入力イベントを入力メソッドにルーティングする。実際の入力ロジックは入力メソッドによって実装されます。

入力エンジンにはデフォルトの入力メソッドも含まれており、アクティブな入力メソッドがイベントを処理できない場合にデフォルトの処理を行います。

プロパティの説明

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 日本語のローマ字入力モード

inputModes : list<int> [read-only]

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


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

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

指定可能な値：

定数説明
InputEngine.PatternRecognitionMode.Noneパターン認識は利用できません。
InputEngine.PatternRecognitionMode.PatternRecognitionDisabledobsolete - 代わりに を使用してください。None
InputEngine.PatternRecognitionMode.Handwriting手書き認識用のパターン認識モード。
InputEngine.PatternRecognitionMode.HandwritingRecoginitionobsolete - 代わりに を使用してください。Handwriting

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


previousKey : int [read-only]

以前に押されたキー。


wordCandidateListModel : SelectionListModel [read-only]

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


wordCandidateListVisibleHint : bool [read-only]

このプロパティを使用して、単語候補リストを 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 。


[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 を使用します。

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

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


void previousKeyChanged(int key)

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

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


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

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

注： 対応するハンドラはonVirtualKeyClicked です。


メソッド・ドキュメント

[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 オブジェクトは、この関数を呼び出した後、いつでも破棄することができます。

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


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 を返す。


© 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.