KeyboardLayout QML Type

キーボード配列。詳細…

• 継承されたメンバーを含む、すべてのメンバーの一覧

プロパティ

• inputMethod : var
• inputMode : int
• keyWeight : real
• sharedLayouts : var
• smallTextVisible : bool (since QtQuick.VirtualKeyboard 2.0)

方法

• createInputMethod()

詳細な説明

このタイプは、キーボードレイアウトのルート要素です。新しいキーボードレイアウトを作成するには、この要素を使用します。

例：

import QtQuick
import QtQuick.Layouts
import QtQuick.VirtualKeyboard

// file: layouts/en_GB/main.qml

KeyboardLayout {
    KeyboardRow {
        Key {
            key: Qt.Key_Q
            text: "q"
        }
        Key {
            key: Qt.Key_W
            text: "w"
        }
        Key {
            key: Qt.Key_E
            text: "e"
        }
        Key {
            key: Qt.Key_R
            text: "r"
        }
        Key {
            key: Qt.Key_T
            text: "t"
        }
        Key {
            key: Qt.Key_Y
            text: "y"
        }
    }
}

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

inputMethod : var

このレイアウトで使用する入力方法を設定します。

このプロパティを使用すると、このレイアウトでカスタム入力方式を使用できるようになります。

inputMode : int

このレイアウトで使用する入力モードを設定します。

デフォルトでは、別のキーボードレイアウトに切り替える際、仮想キーボードは現在の入力モードを維持しようとします。

現在のコンテキストで現在の入力モードが有効でない場合、デフォルトの入力モードは入力方式によって指定されます。

keyWeight : real

すべての子キーの重みを設定します。

デフォルト値は、レイアウト階層内の親要素から継承されます。

sharedLayouts : var

createInputMethod() 関数によって作成された入力メソッドを共有するレイアウト名のリスト。

リストが空の場合（デフォルト）、その入力メソッドは他のレイアウトと共有されず、レイアウトが変更された際に破棄されます。

このリストには、レイアウトタイプの名前（例：['symbols']）のみを含める必要があります。現在のレイアウトをリストに含める必要はありません。

smallTextVisible : bool [since QtQuick.VirtualKeyboard 2.0]

すべての子キーに対して、smallTextVisible を設定します。

デフォルト値は、レイアウト階層上の親要素から継承されます。

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

メソッドのドキュメント

createInputMethod()

この関数は、キーボードレイアウトによってオーバーライドされ、入力メソッドオブジェクトを動的に生成することがあります。デフォルトの実装は、null を返します。

この関数によって作成された入力メソッドオブジェクトは、特定のケースにおいて、キーボードレイアウトの切り替え後も存続することがあります。特に、これはsharedLayouts プロパティに列挙されているレイアウト間の切り替えに当てはまります。