VirtualKeyboardSettings QML Type
仮想キーボードの設定を提供します。詳細...
Import Statement: | import QtQuick.VirtualKeyboard.Settings |
Since: | QtQuick.VirtualKeyboard 1.2 |
プロパティ
- activeLocales : list<string>
(since QtQuick.VirtualKeyboard.Settings 2.0)
- availableLocales : list<string>
(since QtQuick.VirtualKeyboard.Settings 2.0)
- closeOnReturn : bool
(since QtQuick.VirtualKeyboard.Settings 6.8)
- defaultDictionaryDisabled : bool
(since QtQuick.VirtualKeyboard.Settings 6.1)
- defaultInputMethodDisabled : bool
(since QtQuick.VirtualKeyboard.Settings 6.1)
- fullScreenMode : bool
(since QtQuick.VirtualKeyboard.Settings 2.2)
- handwritingModeDisabled : bool
(since QtQuick.VirtualKeyboard.Settings 6.1)
- hwrTimeoutForAlphabetic : bool
(since QtQuick.VirtualKeyboard.Settings 6.1)
- hwrTimeoutForCjk : bool
(since QtQuick.VirtualKeyboard.Settings 6.1)
- inputMethodHints : int
(since QtQuick.VirtualKeyboard.Settings 6.1)
- locale : string
(since QtQuick.VirtualKeyboard.Settings 2.0)
- styleName : string
- userDataPath : bool
(since QtQuick.VirtualKeyboard.Settings 6.1)
- visibleFunctionKeys : enumeration
(since QtQuick.VirtualKeyboard.Settings 6.6)
- wordCandidateList
(since QtQuick.VirtualKeyboard.Settings 2.2)
- wordCandidateList.alwaysVisible : bool
(since QtQuick.VirtualKeyboard.Settings 2.2)
- wordCandidateList.autoHideDelay : int
(since QtQuick.VirtualKeyboard.Settings 2.2)
- wordCandidateList.alwaysVisible : bool
信号
詳細説明
この型はVirtualKeyboardSettingsのシングルトンインスタンスを提供し、仮想キーボード設定を構成するために使用することができます。
つまり、設定の変更は永続的ではありません。
例えば、アプリケーションでキーボードのスタイルを変更する場合などです:
Component.onCompleted: VirtualKeyboardSettings.styleName = "retro"
プロパティ Documentation
このプロパティには、仮想キーボードの有効な言語のリストが含まれます。
アクティブな言語のリストは、使用可能な言語のサブセットであり、アプリケーションのライフタイムで使用可能な言語のリストを制限するために使用することができます。
言語のリストは、指定された順序に基づいて表示されます。
このプロパティは QtQuick.VirtualKeyboard.Settings 2.0 で導入されました。
このプロパティには、仮想キーボードでサポートされている言語のリストが含まれます。
このリストは読み取り専用で、仮想キーボードのビルド時の設定に依存します。
このプロパティは、QtQuick.VirtualKeyboard.Settings 2.0 で導入されました。
closeOnReturn : bool |
このプロパティは、仮想キーボードの非表示を有効にします。
このプロパティをtrue
に設定すると、Qt::Key_Enter またはQt::Key_Return キーが離されたときに仮想キーボードが非表示になります。デフォルトはfalse
です。
このプロパティは、QtQuick.VirtualKeyboard.Settings 6.8で導入されました。
defaultDictionaryDisabled : bool |
このプロパティは、デフォルトの辞書を無効にします。この設定の目的は、標準辞書の代わりにカスタム辞書のみを使用できるようにすることです。
このプロパティは、QtQuick.VirtualKeyboard.Settings 6.1で導入されました。
defaultInputMethodDisabled : bool |
このプロパティは、デフォルトの入力メソッドを無効にします。この設定の目的は、デフォルトの入力メソッドをプレーン入力メソッドでオーバーライドし、その機能を無効にできるようにすることです。
このプロパティは、QtQuick.VirtualKeyboard.Settings 6.1 で導入されました。
fullScreenMode : bool |
このプロパティは、仮想キーボードのフルスクリーンモードを有効にします。
フルスクリーンモードでは、仮想キーボードはフォーカスされた入力フィールドの内容をキーボードの上部にあるフルスクリーン入力フィールドに複製します。
例えば、画面のアスペクト比が 16:9 より大きい場合にフルスクリーンモードを有効にします:
Binding { target: VirtualKeyboardSettings property: "fullScreenMode" value: (Screen.width / Screen.height) > (16.0 / 9.0) }
このプロパティは、QtQuick.VirtualKeyboard.Settings 2.2で導入されました。
handwritingModeDisabled : bool |
このプロパティは、手書き入力モードがシステムで利用可能な場合に、それを無効にすることができます。
このプロパティをtrue
に設定すると、キーボードレイアウトから手書きボタンが非表示になり、ユーザーは手書き入力モードに切り替えることができなくなります。
このプロパティは、QtQuick.VirtualKeyboard.Settings 6.1 で導入されました。
hwrTimeoutForAlphabetic : bool |
このプロパティは、アルファベット言語の手書き認識タイムアウトを設定します。
デフォルトでは、タイムアウトは 500 ミリ秒です。
このプロパティは QtQuick.VirtualKeyboard.Settings 6.1 で導入されました。
hwrTimeoutForCjk : bool |
このプロパティは、中国語/日本語/韓国語の手書き認識タイムアウトを設定します。
デフォルトでは、タイムアウトは 500 ミリ秒です。
このプロパティは QtQuick.VirtualKeyboard.Settings 6.1 で導入されました。
inputMethodHints : int |
このプロパティでは、永続的な入力メソッドのヒントを設定できます。
このプロパティの値は、入力コントロールの入力メソッドのヒントと組み合わされます。例えば、予測入力テキストを無効にするには、このプロパティをQt::ImhNoPredictiveText
に設定します。
このプロパティは、QtQuick.VirtualKeyboard.Settings 6.1 で導入されました。
locale : string |
このプロパティは、キーボードのデフォルトロケールを提供します。
ロケールが指定されていない場合は、デフォルトのシステムロケールが代わりに使用されます。
キーボードのロケールが新しいデフォルトのロケールと異なる場合、キーボードの言語は新しいロケールを反映するように直ちに変更されます。ロケールの設定が正しくない場合や、サポートされているロケールのリストにない場合は、無視され、代わりにデフォルトの設定が使用されます。
ロケールは、availableLocales のリストに含まれていればサポートされています。
このプロパティは、QtQuick.VirtualKeyboard.Settings 2.0 で導入されました。
styleName : string |
このプロパティは、現在のスタイルを提供します。アプリケーションは、styleName に異なる値を設定することで、キーボードスタイルを変更することができます。
システム全体のキーボード・スタイルは、QT_VIRTUALKEYBOARD_STYLE環境変数を設定することによって影響を受けることができます。
userDataPath : bool |
このプロパティは、仮想キーボードとそのプラグインのユーザー・データ・パスを設定します。
デフォルトでは、ユーザー・データ・パスはGenericConfigLocation + "/qtvirtualkeyboard" に設定されます。
このプロパティは、QtQuick.VirtualKeyboard.Settings 6.1で導入されました。
visibleFunctionKeys : enumeration |
この設定は、キーボードレイアウトの特定のファンクションキーの表示/非表示を調整します。ファンクションキーが表示されていなくても、ギアメニューからそのファンクションキーにアクセスできます。
値は以下のフラグの組み合わせになります:
QtVirtualKeyboard.KeyboardFunctionKeys.None
すべてのファンクションキーを隠すQtVirtualKeyboard.KeyboardFunctionKeys.Hide
非表示ファンクションキーが表示されているQtVirtualKeyboard.KeyboardFunctionKeys.Language
言語ファンクションキーが表示されているQtVirtualKeyboard.KeyboardFunctionKeys.All
すべてのファンクションキーを表示
デフォルトはQtVirtualKeyboard.KeyboardFunctionKeys.All
です。
このプロパティは、QtQuick.VirtualKeyboard.Settings 6.6で導入されました。
名前 | 説明 |
---|---|
autoHideDelay | このプロパティは、単語候補リストが空の場合に非表示になるまでの遅延をミリ秒単位で定義します。 値が 値が デフォルト値は |
alwaysVisible | このプロパティは、単語候補リストを常に表示したままにするかどうかを定義します。 デフォルト値は |
autoCommitWord | このプロパティは、単語候補リストが単一の候補に絞り込まれたときに有効になる自動コミット機能を有効にします。 自動コミット機能は、単語候補リストが最初は複数の単語を含み、追加入力後に1つの単語に絞られたときに有効になります。この単語はユーザーの操作なしに自動的に選択され、コミットされます。 このプロパティはデフォルトで |
この QML プロパティは、QtQuick.VirtualKeyboard.Settings 2.2 で導入されました。
シグナルの説明
userDataReset() |
アプリケーションは、ユーザーデータがリセットされる前にこのシグナルをトリガーし、ユーザーデータディレクトリ内のすべてのファイルを閉じる必要があることを仮想キーボードに示します。
注意: 対応するハンドラはonUserDataReset
です。
© 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.