KeyboardLayoutLoader QML Type

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

Import Statement: import QtQuick.VirtualKeyboard.Components
Since: QtQuick.VirtualKeyboard 1.1
Inherits:

Loader

プロパティ

方法

詳細説明

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

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 プロパティにリストされているレイアウト間の遷移に適用されます。


© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.