QVirtualKeyboardInputEngine Class
InputEngine クラスは、C++ と QML の統合をサポートする入力エンジンを提供します。詳細...
Header: | #include <QVirtualKeyboardInputEngine> |
CMake: | find_package(Qt6 REQUIRED COMPONENTS VirtualKeyboard) target_link_libraries(mytarget PRIVATE Qt6::VirtualKeyboard) |
qmake: | QT += virtualkeyboard |
In QML: | InputEngine |
Inherits: | QObject |
パブリックタイプ
enum class | InputMode { Latin, Numeric, Dialable, Pinyin, Cangjie, …, Romaji } |
enum class | PatternRecognitionMode { None, PatternRecognitionDisabled, Handwriting, HandwritingRecoginition } |
enum class | ReselectFlag { WordBeforeCursor, WordAfterCursor, WordAtCursor } |
flags | ReselectFlags |
enum class | TextCase { Lower, Upper } |
プロパティ
|
|
パブリック関数
Qt::Key | activeKey() const |
QVirtualKeyboardInputContext * | inputContext() const |
QVirtualKeyboardAbstractInputMethod * | inputMethod() const |
QVirtualKeyboardInputEngine::InputMode | inputMode() const |
QList<int> | inputModes() const |
QList<int> | patternRecognitionModes() const |
Qt::Key | previousKey() const |
(since QtQuick.VirtualKeyboard 2.0) bool | reselect(int cursorPosition, const QVirtualKeyboardInputEngine::ReselectFlags &reselectFlags) |
void | setInputMethod(QVirtualKeyboardAbstractInputMethod *inputMethod) |
void | setInputMode(QVirtualKeyboardInputEngine::InputMode inputMode) |
(since QtQuick.VirtualKeyboard 2.0) QVirtualKeyboardTrace * | traceBegin(int traceId, QVirtualKeyboardInputEngine::PatternRecognitionMode patternRecognitionMode, const QVariantMap &traceCaptureDeviceInfo, const QVariantMap &traceScreenInfo) |
bool | traceEnd(QVirtualKeyboardTrace *trace) |
void | virtualKeyCancel() |
bool | virtualKeyClick(Qt::Key key, const QString &text, Qt::KeyboardModifiers modifiers) |
bool | virtualKeyPress(Qt::Key key, const QString &text, Qt::KeyboardModifiers modifiers, bool repeat) |
bool | virtualKeyRelease(Qt::Key key, const QString &text, Qt::KeyboardModifiers modifiers) |
QVirtualKeyboardSelectionListModel * | wordCandidateListModel() const |
bool | wordCandidateListVisibleHint() const |
シグナル
void | activeKeyChanged(Qt::Key key) |
void | inputMethodChanged() |
void | inputMethodReset() |
void | inputMethodUpdate() |
void | inputModeChanged() |
void | inputModesChanged() |
(since QtQuick.VirtualKeyboard 2.0) void | patternRecognitionModesChanged() |
void | previousKeyChanged(Qt::Key key) |
void | virtualKeyClicked(Qt::Key key, const QString &text, Qt::KeyboardModifiers modifiers, bool isAutoRepeat) |
void | wordCandidateListModelChanged() |
void | wordCandidateListVisibleHintChanged() |
詳細説明
入力エンジンは、入力イベントを入力メソッドにルーティングする。実際の入力ロジックは入力メソッドによって実装されます。
入力エンジンにはデフォルト入力メソッドも含まれており、アクティブな入力メソッドがイベントを処理できない場合にデフォルトの処理を行います。
メンバ型の説明
enum class QVirtualKeyboardInputEngine::InputMode
この列挙型は、入力メソッドの入力モードを指定します。
定数 | 値 | 説明 |
---|---|---|
QVirtualKeyboardInputEngine::InputMode::Latin | 0 | ラテン文字のデフォルト入力モード。 |
QVirtualKeyboardInputEngine::InputMode::Numeric | 1 | 数値入力のみが許可される。 |
QVirtualKeyboardInputEngine::InputMode::Dialable | 2 | ダイヤル入力のみが許可されます。 |
QVirtualKeyboardInputEngine::InputMode::Pinyin | 3 | 中国語のピンイン入力モード。 |
QVirtualKeyboardInputEngine::InputMode::Cangjie | 4 | 中国語の倉頡入力モード |
QVirtualKeyboardInputEngine::InputMode::Zhuyin | 5 | 中国語のZhuyin入力モード。 |
QVirtualKeyboardInputEngine::InputMode::Hangul | 6 | 韓国語のハングル入力モード |
QVirtualKeyboardInputEngine::InputMode::Hiragana | 7 | 日本語のひらがな入力モード |
QVirtualKeyboardInputEngine::InputMode::Katakana | 8 | 日本語のカタカナ入力モード |
QVirtualKeyboardInputEngine::InputMode::FullwidthLatin | 9 | 東アジア言語の全角ラテン文字入力モード。 |
QVirtualKeyboardInputEngine::InputMode::Greek | 10 | ギリシャ語入力モード |
QVirtualKeyboardInputEngine::InputMode::Cyrillic | 11 | キリル文字入力モード。 |
QVirtualKeyboardInputEngine::InputMode::Arabic | 12 | アラビア語入力モード。 |
QVirtualKeyboardInputEngine::InputMode::Hebrew | 13 | ヘブライ語入力モード。 |
QVirtualKeyboardInputEngine::InputMode::ChineseHandwriting | 14 | 中国語手書き入力モード。 |
QVirtualKeyboardInputEngine::InputMode::JapaneseHandwriting | 15 | 日本語手書き入力モード。 |
QVirtualKeyboardInputEngine::InputMode::KoreanHandwriting | 16 | 韓国語手書き入力モード。 |
QVirtualKeyboardInputEngine::InputMode::Thai | 17 | タイ語入力モード |
QVirtualKeyboardInputEngine::InputMode::Stroke | 18 | 中国語のストローク入力モード |
QVirtualKeyboardInputEngine::InputMode::Romaji | 19 | 日本語のローマ字入力モード。 |
enum class QVirtualKeyboardInputEngine::PatternRecognitionMode
この列挙型は、入力メソッドの入力モードを指定する。
定数 | 値 | 説明 |
---|---|---|
QVirtualKeyboardInputEngine::PatternRecognitionMode::None | 0 | パターン認識は利用できない。 |
QVirtualKeyboardInputEngine::PatternRecognitionMode::PatternRecognitionDisabled | None | obsolete PatternRecognitionMode::None を使用する。 |
QVirtualKeyboardInputEngine::PatternRecognitionMode::Handwriting | 1 | 手書き認識用のパターン認識モード。 |
QVirtualKeyboardInputEngine::PatternRecognitionMode::HandwritingRecoginition | Handwriting | obsolete PatternRecognitionMode::Handwriting を使用してください。 |
enum class QVirtualKeyboardInputEngine::ReselectFlag
flags QVirtualKeyboardInputEngine::ReselectFlags
この enum は単語の再選択ルールを指定します。
定数 | 値 | 説明 |
---|---|---|
QVirtualKeyboardInputEngine::ReselectFlag::WordBeforeCursor | 0x1 | カーソルの前の単語をアクティブにする。このフラグが排他的に使用される場合、単語はカーソルで正確に終了しなければならない。 |
QVirtualKeyboardInputEngine::ReselectFlag::WordAfterCursor | 0x2 | カーソルの後の単語をアクティブにする。このフラグが排他的に使用されるとき、単語は正確にカーソルで始まらなければならない。 |
QVirtualKeyboardInputEngine::ReselectFlag::WordAtCursor | WordBeforeCursor | WordAfterCursor | 単語をカーソルでアクティブにする。このフラグは上記のフラグを組み合わせたものであるが、例外として、単語をカーソルで開始したり停止したりすることはできない。 |
ReselectFlags型はQFlags<ReselectFlag>のtypedefである。これはReselectFlag値のORの組み合わせを格納する。
enum class QVirtualKeyboardInputEngine::TextCase
この列挙型は、入力メソッドのテキスト・ケースを指定します。
定数 | 値 | 説明 |
---|---|---|
QVirtualKeyboardInputEngine::TextCase::Lower | 0 | 小文字テキスト |
QVirtualKeyboardInputEngine::TextCase::Upper | 1 | 大文字テキスト |
プロパティの説明
[read-only]
activeKey : const Qt::Key
このプロパティはアクティブキーを保持します。
現在押されているキー。
アクセス関数:
Qt::Key | activeKey() const |
通知シグナル
void | activeKeyChanged(Qt::Key key) |
inputMethod : QVirtualKeyboardAbstractInputMethod*
このプロパティは、アクティブな入力メソッドを保持します。
このプロパティを使用して、入力方法をアクティブに設定したり、アクティブな入力方法が変更されたときに監視したりします。
アクセス関数
QVirtualKeyboardAbstractInputMethod * | inputMethod() const |
void | setInputMethod(QVirtualKeyboardAbstractInputMethod *inputMethod) |
ノーティファイア信号:現在の入力モードを保持する:
void | inputMethodChanged() |
inputMode : InputMode
このプロパティは、現在の入力モードを保持する。
このプロパティを使用して、現在の入力モードを取得または設定する。InputEngine::inputModes は、現在の入力メソッドとロケールに対して有効な入力モードのリストを提供する。
アクセス関数
QVirtualKeyboardInputEngine::InputMode | inputMode() const |
void | setInputMode(QVirtualKeyboardInputEngine::InputMode inputMode) |
ノーティファイアシグナル:
void | inputModeChanged() |
[read-only]
inputModes : const QList<int>
このプロパティは、アクティブな入力メソッドで利用可能な入力モードを保持する。
利用可能な入力モードのリストは、入力メソッドとロケールに依存する。依存関係のいずれかが変更されると、このプロパティは更新される。
アクセス関数:
QList<int> | inputModes() const |
ノーティファイアシグナル:
void | inputModesChanged() |
[read-only, since QtQuick.VirtualKeyboard 2.0]
patternRecognitionModes : const QList<int>
このプロパティは、利用可能なパターン認識モードのリストを保持する。
利用可能なパターン認識モードのリスト。
このプロパティは QtQuick.VirtualKeyboard 2.0 で導入されました。
このプロパティはQtQuick.VirtualKeyboard 2.0で導入されました:
QList<int> | patternRecognitionModes() const |
ノーティファイア信号:
[read-only]
previousKey : const Qt::Key
このプロパティは、前回アクティブだったキーを保持します。
前に押されたキー。
アクセス関数です:
Qt::Key | previousKey() const |
ノーティファイアシグナル:
void | previousKeyChanged(Qt::Key key) |
[read-only]
wordCandidateListModel : QVirtualKeyboardSelectionListModel* const
単語候補リストのリストモデル。
このプロパティを使用して、単語候補リストのリストモデルにアクセスします。
アクセス関数:
QVirtualKeyboardSelectionListModel * | wordCandidateListModel() const |
ノーティファイアシグナル:
void | wordCandidateListModelChanged() |
[read-only]
wordCandidateListVisibleHint : const bool
単語候補リストの表示ヒント。
このプロパティを使用して、単語候補リストをUIで表示するかどうかをチェックします。
アクセス関数
bool | wordCandidateListVisibleHint() const |
通知シグナル
void | wordCandidateListVisibleHintChanged() |
メンバー関数ドキュメント
Qt::Key QVirtualKeyboardInputEngine::activeKey() const
現在アクティブなキーを返し、キーがアクティブでない場合はQt::Key_unknown を返す。
備考: プロパティ activeKey のゲッター関数。
[signal]
void QVirtualKeyboardInputEngine::activeKeyChanged(Qt::Key key)
アクティブなkey が変更されたことを示す。
備考: プロパティactiveKey に対するノーティファイアシグナル。
QVirtualKeyboardInputContext *QVirtualKeyboardInputEngine::inputContext() const
入力エンジンに関連付けられたInputContext
インスタンスを返します。
QVirtualKeyboardAbstractInputMethod *QVirtualKeyboardInputEngine::inputMethod() const
アクティブな入力メソッドを返す。
メモ: inputMethod プロパティのゲッター関数。
setInputMethod()も参照 。
[signal]
void QVirtualKeyboardInputEngine::inputMethodChanged()
入力メソッドが変更されたことを示す。
注: プロパティinputMethod に対するノーティファイア・シグナル。
[signal]
void QVirtualKeyboardInputEngine::inputMethodReset()
入力メソッドをリセットする必要があるときに発せられる。
注 :このシグナルは、入力メソッドがアクティブになると、自動的にQVirtualKeyboardAbstractInputMethod::reset() とInputMethod::reset() に接続される。
[signal]
void QVirtualKeyboardInputEngine::inputMethodUpdate()
注) この信号は、入力方式がアクティブになると、自動的にQVirtualKeyboardAbstractInputMethod::update ()とInputMethod::update ()に接続される。
[signal]
void QVirtualKeyboardInputEngine::inputModeChanged()
入力モードが変更されたことを示す。
注: プロパティinputMode のノーティファイア信号。
QList<int> QVirtualKeyboardInputEngine::inputModes() const
利用可能な入力モードのリストを返す。
注: プロパティ inputModes のゲッター関数。
[signal]
void QVirtualKeyboardInputEngine::inputModesChanged()
利用可能な入力モードが変更されたことを示す。
注: プロパティinputModes に対するノーティファイアシグナル。
QList<int> QVirtualKeyboardInputEngine::patternRecognitionModes() const
対応するパターン認識モードのリストを返す。
注: プロパティ patternRecognitionModes に対するゲッター関数。
[signal, since QtQuick.VirtualKeyboard 2.0]
void QVirtualKeyboardInputEngine::patternRecognitionModesChanged()
利用可能なパターン認識モードが変更されたことを示す。
注: プロパティpatternRecognitionModes のノーティファイアシグナル。
この関数は、QtQuick.VirtualKeyboard 2.0 で導入されました。
Qt::Key QVirtualKeyboardInputEngine::previousKey() const
以前にアクティブだったキーを返し、キーがアクティブでなかった場合はQt::Key_unknown を返します。
注: プロパティ previousKey のゲッター関数です。
[signal]
void QVirtualKeyboardInputEngine::previousKeyChanged(Qt::Key key)
前のkey が変更されたことを示します。
注: プロパティpreviousKey に対するノーティファイア・シグナル。
[invokable, since QtQuick.VirtualKeyboard 2.0]
bool QVirtualKeyboardInputEngine::reselect(int cursorPosition, const QVirtualKeyboardInputEngine::ReselectFlags &reselectFlags)
この関数は、cursorPosition に位置する単語の再選択を試みる。reselectFlags は、カーソル位置に対する単語の選択方法の規則を定義する。
この関数は、単語の再選択に成功した場合、true
を返します。
注意: この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
この関数は QtQuick.VirtualKeyboard 2.0 で導入されました。
void QVirtualKeyboardInputEngine::setInputMethod(QVirtualKeyboardAbstractInputMethod *inputMethod)
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() メソッドを呼び出すことで終了する。
注意: この関数はメタオブジェクトシステムおよび QML から呼び出すことができます。Q_INVOKABLE を参照してください。
この関数は QtQuick.VirtualKeyboard 2.0 で導入されました。
[invokable]
bool QVirtualKeyboardInputEngine::traceEnd(QVirtualKeyboardTrace *trace)
入力エンジンとのトレースインタラクションを終了します。
trace オブジェクトは、この関数を呼び出した後、いつでも破棄することができます。
この関数は、トレースインタラクションが受け入れられた場合、trueを返します(つまり、タッチイベントは他のことに使用されるべきではありません)。
注意: この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
[invokable]
void QVirtualKeyboardInputEngine::virtualKeyCancel()
キーイベントを発生させずに、アクティブなキーの状態を戻します。このメソッドは、ユーザが現在のキーを破棄し、キーの状態を元に戻す必要がある場合に便利です。
注意: この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
[invokable]
bool QVirtualKeyboardInputEngine::virtualKeyClick(Qt::Key key, const QString &text, Qt::KeyboardModifiers modifiers)
与えられたkey,text,modifiers のキークリックイベントを発生させます。キーイベントが入力エンジンに受け入れられた場合はtrue
を返します。
注意: この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
[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)
与えられたtext とmodifiers で、key が押されたことを示すためにキーボードレイヤーによって呼び出されます。
key はアクティブキー(ダウンキー)として設定される。実際のキーイベントは、virtualKeyRelease() メソッドによってキーが離されたときにトリガーされます。キー押下イベントは、virtualKeyCancel() を呼び出すことで破棄できます。
キーが押されると、repeat がtrue
の場合、キーリピート・タイマーも開始されます。
キーがこの入力エンジンに受け入れられた場合はtrue
を返す。
注意: この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照。
virtualKeyCancel() およびvirtualKeyRelease()も参照 。
[invokable]
bool QVirtualKeyboardInputEngine::virtualKeyRelease(Qt::Key key, const QString &text, Qt::KeyboardModifiers modifiers)
key でキーを解放します。このメソッドは、繰り返しタイマーによってイベントが生成されていない場合、 入力メソッドのキーイベントを発行します。text とmodifiers が入力メソッドに渡される。
キーが入力エンジンに受け入れられた場合はtrue
を返す。
注意: この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
©2024 The Qt Company Ltd. 本文書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。