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


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