KeyboardLayoutLoader QML 类型

允许动态加载键盘布局。更多信息...

导入声明	import QtQuick.VirtualKeyboard.Components
自	QtQuick.VirtualKeyboard 1.1
继承	Loader

所有成员的列表，包括继承的成员

属性

inputMethod : var
inputMode : int
sharedLayouts : var

方法

createInputMethod()

详细描述

该类型适用于由多页键组成的键盘布局。

单个键盘布局（一页）通过将组件用作容器来定义。然后可以通过设置 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属性中所列布局之间的转换。