KeyboardLayoutLoader QML Type

キーボードレイアウトの動的読み込みを可能にします。詳細...

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

プロパティ

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

方法

• createInputMethod()

詳細説明

このタイプは、複数のページからなるキー配列に役立ちます。

単一のキーボードレイアウト（1ページ）は、このコンポーネントをコンテナとして使用して定義されます。その後、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 プロパティにリストされているレイアウト間の切り替えにおいて、この現象が発生します。