QVirtualKeyboardInputEngine Class

メンバ関数のドキュメント

Qt::Key QVirtualKeyboardInputEngine::activeKey() const

現在アクティブなキーを返します。アクティブなキーがない場合は、Qt::Key_unknown を返します。

[signal] void QVirtualKeyboardInputEngine::activeKeyChanged(Qt::Key key)

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

QVirtualKeyboardInputContext *QVirtualKeyboardInputEngine::inputContext() const

入力エンジンに関連付けられたInputContext インスタンスを返します。

QVirtualKeyboardAbstractInputMethod *QVirtualKeyboardInputEngine::inputMethod() const

アクティブな入力方式を取得します。

関連項目： setInputMethod()。

[signal] void QVirtualKeyboardInputEngine::inputMethodChanged()

入力方式が変更されたことを示します。

[signal] void QVirtualKeyboardInputEngine::inputMethodReset()

入力方式をリセットする必要がある際に発火します。

[signal] void QVirtualKeyboardInputEngine::inputMethodUpdate()

[signal] void QVirtualKeyboardInputEngine::inputModeChanged()

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

QList<int> QVirtualKeyboardInputEngine::inputModes() const

利用可能な入力モードのリストを返します。

[signal] void QVirtualKeyboardInputEngine::inputModesChanged()

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

QList<int> QVirtualKeyboardInputEngine::patternRecognitionModes() const

サポートされているパターン認識モードの一覧を返します。

[signal, since QtQuick.VirtualKeyboard 2.0] void QVirtualKeyboardInputEngine::patternRecognitionModesChanged()

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

この関数は、QtQuick.VirtualKeyboard 2.0で導入されました。

Qt::Key QVirtualKeyboardInputEngine::previousKey() const

以前にアクティブだったキーを返します。アクティブなキーがない場合は、Qt::Key_unknown を返します。

[signal] void QVirtualKeyboardInputEngine::previousKeyChanged(Qt::Key key)

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

[invokable, since QtQuick.VirtualKeyboard 2.0] bool QVirtualKeyboardInputEngine::reselect(int cursorPosition, const QVirtualKeyboardInputEngine::ReselectFlags &reselectFlags)

この関数は、cursorPosition にある単語を再選択しようとします。reselectFlags は、カーソル位置との関係で単語をどのように選択すべきかというルールを定義します。

単語の再選択に成功した場合、この関数は `true ` を返します。

この関数は、QtQuick.VirtualKeyboard 2.0 で導入されました。

void QVirtualKeyboardInputEngine::setInputMethod(QVirtualKeyboardAbstractInputMethod *inputMethod)

inputMethod をアクティブな入力方式として設定します。

関連項目：inputMethod()も参照してください 。

[invokable, since QtQuick.VirtualKeyboard 2.0] QVirtualKeyboardTrace *QVirtualKeyboardInputEngine::traceBegin(int traceId, QVirtualKeyboardInputEngine::PatternRecognitionMode patternRecognitionMode, const QVariantMap &traceCaptureDeviceInfo, const QVariantMap &traceScreenInfo)

入力エンジンとのトレースのやり取りを開始します。

トレースは、traceId によって一意に識別されます。入力メソッドがイベントを受け入れた場合、入力エンジンはQVirtualKeyboardTrace オブジェクトにこのIDを割り当てます。

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

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

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

定義上、QVirtualKeyboardTrace オブジェクトは、traceEnd() メソッドが呼び出されるまで有効です。

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

この関数は、QtQuick.VirtualKeyboard 2.0 で導入されました。

[invokable] bool QVirtualKeyboardInputEngine::traceEnd(QVirtualKeyboardTrace *trace)

入力エンジンとのトレースのやり取りを終了します。

この関数を呼び出した後は、trace オブジェクトをいつでも破棄しても構いません。

トレースの連携が受け入れられた場合（つまり、タッチイベントが他の目的には使用されない場合）、この関数は true を返します。

[invokable] void QVirtualKeyboardInputEngine::virtualKeyCancel()

キーイベントを発火させることなく、アクティブなキーの状態を元に戻します。このメソッドは、ユーザーが現在のキーを解除し、キーの状態を復元する必要がある場合に役立ちます。

[invokable] bool QVirtualKeyboardInputEngine::virtualKeyClick(Qt::Key key, const QString &text, Qt::KeyboardModifiers modifiers)

指定されたkey 、text 、modifiers に対して、キークリックイベントを発行します。キーイベントが入力エンジンによって受け入れられた場合は、true を返します。

[signal] void QVirtualKeyboardInputEngine::virtualKeyClicked(Qt::Key key, const QString &text, Qt::KeyboardModifiers modifiers, bool isAutoRepeat)

指定されたtext およびmodifiers で、仮想key がクリックされたことを示します。isAutoRepeat は、キーが押されている間、イベントが自動的に繰り返されるかどうかを示します。このシグナルは、入力方式がキーイベントを処理した後に発せられます。

[invokable] bool QVirtualKeyboardInputEngine::virtualKeyPress(Qt::Key key, const QString &text, Qt::KeyboardModifiers modifiers, bool repeat)

キーボードレイヤーによって呼び出され、key が押されたことを示すもので、指定されたtext およびmodifiers が渡されます。

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

また、repeat がtrue の場合、キーの押下によってキーリピートタイマーが開始されます。

キーがこの入力エンジンによって受け入れられた場合、true を返します。

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

[invokable] bool QVirtualKeyboardInputEngine::virtualKeyRelease(Qt::Key key, const QString &text, Qt::KeyboardModifiers modifiers)

key でキーを解放します。このメソッドは、イベントが繰り返しタイマーによって生成されたものではない場合、入力メソッドに対してキーイベントを発生させます。text およびmodifiers が入力メソッドに渡されます。

キーが入力エンジンによって受け入れられた場合、true を返します。