KeyboardLayoutLoader QML Type

キーボードレイアウトの動的読み込みを許可する。詳細...

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

プロパティ

• inputMethod : var
• inputMode : int
• sharedLayouts : var

方法

• createInputMethod()

詳細説明

このタイプは、複数のキーのページからなるキーボードレイアウトに便利です。

1つのキーボードレイアウト（1ページ）は、Componentをコンテナとして使用することで定義されます。アクティブなキーボードレイアウトは、sourceComponentプロパティを別の値に設定することで変更できます。

例

import QtQuick
import QtQuick.Layouts
import QtQuick.VirtualKeyboard

// file: layouts/en_GB/symbols.qml

KeyboardLayoutLoader {
    property bool secondPage
    onVisibleChanged: if (!visible) secondPage = false
    sourceComponent: secondPage ? page2 : page1
    Component {
        id: page1
        KeyboardLayout {
            // Keyboard layout definition for page 1
        }
    }
    Component {
        id: page2
        KeyboardLayout {
            // Keyboard layout definition for page 2
        }
    }
}

プロパティの説明

inputMethod : var

このコンテキストに読み込まれているすべてのキーボードレイアウトの入力メソッドを設定します。

入力メソッドは、キーボードレイアウトごとに個別に設定することも、このコンテキストで共通に設定することもできます。別々に設定された場合、このプロパティは変更されるべきではありません。

inputMode : int

このコンテキストにロードされているすべてのキーボードレイアウトの入力モードを設定する。

入力モードは、キーボードレイアウトごとに個別に設定することも、このコンテキストで共通に設定することもできます。別々に設定された場合、このプロパティは変更されるべきではありません。

sharedLayouts : var

createInputMethod() 関数で作成した入力メソッドを共有するレイアウト名のリスト。

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

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

メソッドのドキュメント

createInputMethod()

この関数はキーボード・レイアウトによってオーバーライドされ、入力メソッド・オブジェクトを動的に生成することができる。デフォルトの実装では、呼び出しは子キーボードレイアウトに転送されます。

この関数によって生成された入力メソッドオブジェクトは、場合によってはキーボードレイアウトの遷移よりも長生きすることがあります。特に、sharedLayouts プロパティにリストされているレイアウト間の遷移に適用されます。