VirtualKeyboardSettings QML Type

仮想キーボードの設定を提供します。詳細...

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

プロパティ

• activeLocales : list<string> (since QtQuick.VirtualKeyboard.Settings 2.0)
• arrowKeyNavigationEnabled : bool (since 6.11)
• availableLocales : list<string> (since QtQuick.VirtualKeyboard.Settings 2.0)
• closeOnReturn : bool (since 6.8)
• defaultDictionaryDisabled : bool (since 6.1)
• defaultInputMethodDisabled : bool (since 6.1)
• fullScreenMode : bool (since QtQuick.VirtualKeyboard.Settings 2.2)
• handwritingModeDisabled : bool (since 6.1)
• hwrTimeoutForAlphabetic : bool (since 6.1)
• hwrTimeoutForCjk : bool (since 6.1)
• inputMethodHints : int (since 6.1)
• keySoundVolume : real (since 6.9)
• locale : string (since QtQuick.VirtualKeyboard.Settings 2.0)
• styleName : string
• userDataPath : bool (since 6.1)
• visibleFunctionKeys : enumeration (since 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)

信号

• userDataReset()

詳細説明

この型はVirtualKeyboardSettingsのシングルトンインスタンスを提供し、仮想キーボード設定を構成するために使用することができます。

つまり、設定の変更は永続的ではありません。

例えば、アプリケーションでキーボードのスタイルを変更する場合などです：

Component.onCompleted: VirtualKeyboardSettings.styleName = "retro"

プロパティ・ドキュメント

activeLocales : list<string> [since QtQuick.VirtualKeyboard.Settings 2.0]

このプロパティには、仮想キーボードのアクティブな言語のリストが含まれます。

アクティブな言語のリストは、使用可能な言語のサブセットであり、アプリケーションのライフタイムで使用可能な言語のリストを制限するために使用することができます。

言語のリストは、指定された順序に基づいて表示されます。

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

arrowKeyNavigationEnabled : bool [since 6.11]

このプロパティを使用して、矢印キーナビゲーションを有効または無効にします。

このプロパティは Qt 6.11 で導入されました。

availableLocales : list<string> [read-only, since QtQuick.VirtualKeyboard.Settings 2.0]

このプロパティには、仮想キーボードがサポートする言語のリストが含まれます。

このリストは読み取り専用で、仮想キーボードのビルド時の設定に依存します。

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

closeOnReturn : bool [since 6.8]

このプロパティは、仮想キーボードの非表示を有効にする。

このプロパティをtrue に設定すると、Qt::Key_Enter またはQt::Key_Return キーが離されたときに仮想キーボードが非表示になります。デフォルトはfalse です。

このプロパティは Qt 6.8 で導入されました。

defaultDictionaryDisabled : bool [since 6.1]

このプロパティは、デフォルト辞書を無効にする。この設定の目的は、標準辞書の代わりにカスタム辞書のみを使用できるようにすることです。

このプロパティはQt 6.1で導入された。

defaultInputMethodDisabled : bool [since 6.1]

このプロパティは、デフォルトの入力メソッドを無効にします。この設定の目的は、デフォルトの入力メソッドをプレーンな入力メソッドでオーバーライドし、その機能を無効にすることです。

このプロパティは Qt 6.1 で導入されました。

fullScreenMode : bool [since QtQuick.VirtualKeyboard.Settings 2.2]

このプロパティは、仮想キーボードのフルスクリーンモードを有効にします。

フルスクリーンモードでは、仮想キーボードはフォーカスされた入力フィールドの内容をキーボードの上部にあるフルスクリーン入力フィールドに複製します。

例えば、画面のアスペクト比が 16:9 より大きい場合にフルスクリーンモードを有効にします：

Binding {
    target: VirtualKeyboardSettings
    property: "fullScreenMode"
    value: (Screen.width / Screen.height) > (16.0 / 9.0)
}

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

handwritingModeDisabled : bool [since 6.1]

このプロパティは、手書き入力モードがシステムで利用可能な場合、それを無効にすることができる。

このプロパティをtrue に設定すると、キーボードレイアウトから手書きボタンが非表示になり、ユーザは手書き入力モードに切り替えることができなくなります。

このプロパティは Qt 6.1 で導入されました。

hwrTimeoutForAlphabetic : bool [since 6.1]

このプロパティは、アルファベット言語の手書き認識タイムアウトを設定します。

デフォルトでは、タイムアウトは 500 ミリ秒です。

このプロパティは Qt 6.1 で導入されました。

hwrTimeoutForCjk : bool [since 6.1]

このプロパティは、中国語/日本語/韓国語の手書き認識タイムアウトを設定します。

デフォルトでは、タイムアウトは 500 ミリ秒です。

このプロパティは Qt 6.1 で導入されました。

inputMethodHints : int [since 6.1]

このプロパティにより、永続的な入力メソッドのヒントを設定することができる。

このプロパティの値は、入力コントロールの入力メソッドヒントと組み合わされる。例えば、予測入力テキストを無効にするには、このプロパティをQt::ImhNoPredictiveText に設定します。

このプロパティは Qt 6.1 で導入されました。

keySoundVolume : real [since 6.9]

このプロパティは、キーサウンドの音量レベルを保持します。レベルは[0,1]の範囲です。

このプロパティはQt 6.9で導入されました。

locale : string [since QtQuick.VirtualKeyboard.Settings 2.0]

このプロパティはキーボードのデフォルトロケールを提供する。

ロケールが指定されていない場合は、デフォルトのシステムロケールが代わりに使用されます。

キーボードのロケールが新しいデフォルトロケールと異なる場合、キーボード言語は新しいロケールを反映するように直ちに変更されます。ロケールの設定が正しくない場合や、サポートされているロケールのリストにない場合は、無視され、代わりにデフォルトの設定が使用されます。

ロケールは、availableLocales のリストに含まれていればサポートされています。

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

styleName : string

このプロパティは、現在のスタイルを提供します。アプリケーションは、styleNameを異なる値に設定することで、キーボード・スタイルを変更できます。

システム全体のキーボード・スタイルは、QT_VIRTUALKEYBOARD_STYLE環境変数を設定することによって影響を受けることができます。

userDataPath : bool [since 6.1]

このプロパティは、仮想キーボードとそのプラグインのユーザー・データ・パスを設定します。

デフォルトでは、ユーザー・データ・パスはGenericConfigLocation + "/qtvirtualkeyboard" に設定されます。

このプロパティは Qt 6.1 で導入されました。

visibleFunctionKeys : enumeration [since 6.6]

この設定は、キーボードレイアウトの特定のファンクションキーの表示/非表示を調整します。ファンクションキーが表示されていなくても、ギアメニューからそのファンクションキーにアクセスできます。

値は以下のフラグの組み合わせになります：

• QtVirtualKeyboard.KeyboardFunctionKeys.None すべてのファンクションキーを隠す
• QtVirtualKeyboard.KeyboardFunctionKeys.Hide 非表示ファンクションキーが表示されている
• QtVirtualKeyboard.KeyboardFunctionKeys.Language 言語ファンクションキーが表示されている
• QtVirtualKeyboard.KeyboardFunctionKeys.All すべてのファンクションキーを表示

デフォルトはQtVirtualKeyboard.KeyboardFunctionKeys.All です。

このプロパティは Qt 6.6 で導入されました。

wordCandidateList group

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

Signal ドキュメント

userDataReset()

アプリケーションは、ユーザー・データがリセットされる前にこのシグナルをトリガーし、 ユーザー・データ・ディレクトリ内のすべてのファイルを閉じなければならないことを仮想 キーボードに示します。