VirtualKeyboardSettings QML Type

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

Import Statement: import QtQuick.VirtualKeyboard.Settings
Since: QtQuick.VirtualKeyboard 1.2

プロパティ

シグナル

詳細説明

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

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

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

Component.onCompleted: VirtualKeyboardSettings.styleName = "retro"

プロパティ Documentation

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

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

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

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

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


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

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

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

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


closeOnReturn : bool [since QtQuick.VirtualKeyboard.Settings 6.8]

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

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

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


defaultDictionaryDisabled : bool [since QtQuick.VirtualKeyboard.Settings 6.1]

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

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


defaultInputMethodDisabled : bool [since QtQuick.VirtualKeyboard.Settings 6.1]

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

このプロパティは、QtQuick.VirtualKeyboard.Settings 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 QtQuick.VirtualKeyboard.Settings 6.1]

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

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

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


hwrTimeoutForAlphabetic : bool [since QtQuick.VirtualKeyboard.Settings 6.1]

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

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

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


hwrTimeoutForCjk : bool [since QtQuick.VirtualKeyboard.Settings 6.1]

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

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

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


inputMethodHints : int [since QtQuick.VirtualKeyboard.Settings 6.1]

このプロパティでは、永続的な入力メソッドのヒントを設定できます。

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

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


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

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

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

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

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

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


styleName : string

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

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


userDataPath : bool [since QtQuick.VirtualKeyboard.Settings 6.1]

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

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

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


visibleFunctionKeys : enumeration [since QtQuick.VirtualKeyboard.Settings 6.6]

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

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

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

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

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


wordCandidateList group

wordCandidateList.alwaysVisible : bool [since QtQuick.VirtualKeyboard.Settings 2.2]

wordCandidateList.autoHideDelay : int [since QtQuick.VirtualKeyboard.Settings 2.2]

名前説明
autoHideDelayこのプロパティは、単語候補リストが空の場合に非表示になるまでの遅延をミリ秒単位で定義します。

値が0 の場合、リストはクリアされると即座に非表示になります。

値が-1 の場合、入力フォーカスが変更されるか、入力パネルが非表示になるまで、リストは表示されます。

デフォルト値は5000 ミリ秒です。

alwaysVisibleこのプロパティは、単語候補リストを常に表示したままにするかどうかを定義します。

デフォルト値はfalse です。

autoCommitWordこのプロパティは、単語候補リストが単一の候補に絞り込まれたときに有効になる自動コミット機能を有効にします。

自動コミット機能は、単語候補リストが最初は複数の単語を含み、追加入力後に1つの単語に絞られたときに有効になります。この単語はユーザーの操作なしに自動的に選択され、コミットされます。

このプロパティはデフォルトでfalse に設定されています。

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


シグナルの説明

userDataReset()

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

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


本書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。