KeyboardStyle QML 类型

提供虚拟键盘的样式接口。 更多...

导入声明import QtQuick.VirtualKeyboard.Styles
继承自

QtObject

属性

详细说明

样式类型提供由 InputPanel 使用的样式定义，用于装饰虚拟键盘。

设计大小指定虚拟键盘的宽高比。样式根据 scaleHint 缩放，这是根据键盘的实际高度和设计高度计算的。

属性文档

alternateKeysListBackground : Component

替代键列表背景的模板。


alternateKeysListBottomMargin : real

替代键列表面板的底部边距。


alternateKeysListDelegate : Component

替代键列表项的模板。

注意：该委托在 ListView 中使用。


alternateKeysListHighlight : Component

替代键列表高亮的模板。

注意：该委托用作 ListView.highlight。


alternateKeysListItemHeight : real

替代键列表项的高度。


alternateKeysListItemWidth : real

替代键列表项的宽度。


alternateKeysListLeftMargin : real

替代键列表面板的左边距。


alternateKeysListRightMargin : real

替代键列表面板的右边距。


alternateKeysListTopMargin : 实数

替换键列表面板的顶部边距。


backspaceKeyPanel : 组件

退格键的模板。

注意： 代理必须基于键面板类型。


characterPreviewDelegate : 组件

字符预览弹出窗口的模板。

如果代理包含 text 属性，则在组件激活时，使用显示文本更新该属性。

property string text

示例

characterPreviewDelegate: Item {
    property string text
    id: characterPreview
    Rectangle {
        id: characterPreviewBackground
        anchors.fill: parent
        ...
        Text {
            text: characterPreview.text
            anchors.fill: parent
            ...
        }
    }
}

characterPreviewMargin : 实数

每个键顶部与characterPreviewDelegate底部之间的像素数。


enterKeyPanel : 组件

回车键的模板。

注意： 代理必须基于键面板类型。


fullScreenInputBackground : 组件 [自 QtQuick.VirtualKeyboard.Styles 2.2]

此属性持有全屏输入的背景代理。

此属性在 QtQuick.VirtualKeyboard.Styles 2.2 中引入。


fullScreenInputColor : 颜色 [自 QtQuick.VirtualKeyboard.Styles 2.2]

此属性持有全屏输入字段的文本颜色。

默认颜色为黑色。

此属性在 QtQuick.VirtualKeyboard.Styles 2.2 中引入。


fullScreenInputContainerBackground : 组件 [自 QtQuick.VirtualKeyboard.Styles 2.2]

此属性持有全屏输入容器背景的代理。

此属性在 QtQuick.VirtualKeyboard.Styles 2.2 中引入。


fullScreenInputCursor : 组件 [自 QtQuick.VirtualKeyboard.Styles 2.2]

此属性持有全屏输入字段中的光标代理。

代理应根据为全屏输入字段定义的 parent.blinkStatus 属性切换光标的可见性。例如

fullScreenInputCursor: Rectangle {
    width: 1
    color: "#000"
    visible: parent.blinkStatus
}

此属性在 QtQuick.VirtualKeyboard.Styles 2.2 中引入。


fullScreenInputFont : 字体 [自 QtQuick.VirtualKeyboard.Styles 2.2]

此属性持有全屏输入字段的字体。

此属性在 QtQuick.VirtualKeyboard.Styles 2.2 中引入。


fullScreenInputMargins : 实数 [自 QtQuick.VirtualKeyboard.Styles 2.2]

此属性持有全屏输入字段周围的边距。

默认值是 0。

此属性在 QtQuick.VirtualKeyboard.Styles 2.2 中引入。


fullScreenInputPadding : 实数 [自 QtQuick.VirtualKeyboard.Styles 2.2]

此属性持有全屏输入内容周围的填充。

默认值是 0。

此属性在 QtQuick.VirtualKeyboard.Styles 2.2 中引入。


fullScreenInputPasswordCharacter : 字符串 [自 QtQuick.VirtualKeyboard.Styles 2.2]

此属性持有全屏输入字段的密码掩码字符。

此属性在 QtQuick.VirtualKeyboard.Styles 2.2 中引入。


fullScreenInputSelectedTextColor : 颜色 [自 QtQuick.VirtualKeyboard.Styles 2.2]

此属性持有全屏输入字段选中文本的颜色。

默认颜色设置为 fullScreenInputColor。

此属性在 QtQuick.VirtualKeyboard.Styles 2.2 中引入。


fullScreenInputSelectionColor : 颜色 [自 QtQuick.VirtualKeyboard.Styles 2.2]

此属性持有全屏输入字段的选区颜色。

默认颜色为半透明的黑色。

此属性在 QtQuick.VirtualKeyboard.Styles 2.2 中引入。


functionPopupListBackground : 组件 [自 QtQuick.VirtualKeyboard.Styles 6.2]

功能弹出列表背景模板。

此属性在 QtQuick.VirtualKeyboard.Styles 6.2 中引入。


functionPopupListDelegate : 组件 [自 QtQuick.VirtualKeyboard.Styles 6.2 起存在]

功能列表项模板。

注意：该委托在 ListView 中使用。

以下属性可用于项

  • keyboardFunction - 当前项的键盘功能。

此属性在 QtQuick.VirtualKeyboard.Styles 6.2 中引入。


functionPopupListHighlight : 组件 [自 QtQuick.VirtualKeyboard.Styles 6.2 起存在]

功能弹出列表高亮模板。

注意：该委托用作 ListView.highlight。

此属性在 QtQuick.VirtualKeyboard.Styles 6.2 中引入。


handwritingKeyPanel : 组件

手写模式键模板。

注意： 代理必须基于键面板类型。


hideKeyPanel : 组件

隐藏键模板。

注意： 代理必须基于键面板类型。


keyPanel : 组件

常规键模板。

注意： 代理必须基于键面板类型。

示例

keyPanel: KeyPanel {
    Rectangle {
        anchors.fill: parent
        ...
        Text {
            anchors.fill: parent
            text: control.displayText
            ...
        }
    }
}

keyboardBackground : 组件

键盘背景模板。

示例

keyboardBackground: Rectangle {
    color: "black"
}

keyboardDesignHeight : 实数

键盘的设计高度。


keyboardDesignWidth : 实数

键盘的设计宽度。


keyboardHeight : 实数

键盘的当前高度。


keyboardRelativeBottomMargin : 实数

最低按键与键盘容器底部边缘的距离，以键盘高度的百分比表示（0.0 - 1.0）。


keyboardRelativeLeftMargin : 实数

最左侧按键与键盘左侧边缘的距离，以键盘宽度的百分比表示（0.0 - 1.0）。


keyboardRelativeRightMargin : 实数

最右侧按键与键盘右侧边缘的距离，以键盘宽度的百分比表示（0.0 - 1.0）。

此值与键盘宽度成比例。


keyboardRelativeTopMargin : 实数

最高按键与键盘顶边缘的距离，以键盘高度的百分比表示（0.0 - 1.0）。


languageKeyPanel : 组件

语言键模板。

注意： 代理必须基于键面板类型。


languageListAdd : 过渡动画 [自 QtQuick.VirtualKeyboard.Styles 2.1 起存在]

该属性包含用于添加到语言列表视图的项的过渡动画。

此属性在 QtQuick.VirtualKeyboard.Styles 2.1 中引入。


languageListBackground : 组件 [自 QtQuick.VirtualKeyboard.Styles 2.1 起存在]

语言列表背景模板。

此属性在 QtQuick.VirtualKeyboard.Styles 2.1 中引入。


languageListDelegate : 组件 [自 QtQuick.VirtualKeyboard.Styles 2.1 起存在]

语言列表项模板。

注意：该委托在 ListView 中使用。

注意：委托必须基于 SelectionListItem 类型。

以下属性可用于项

  • displayName 语言显示名称。

此属性在 QtQuick.VirtualKeyboard.Styles 2.1 中引入。


languageListHighlight : 组件 [自 QtQuick.VirtualKeyboard.Styles 2.1 起存在]

语言列表高亮模板。

注意：该委托用作 ListView.highlight。

此属性在 QtQuick.VirtualKeyboard.Styles 2.1 中引入。


languageListRemove : Transition [自 QtQuick.VirtualKeyboard.Styles 2.1 起存在]

此属性保留应用于从语言列表视图中删除的项的过渡。

此属性在 QtQuick.VirtualKeyboard.Styles 2.1 中引入。


languagePopupListEnabled : bool [自 QtQuick.VirtualKeyboard.Styles 2.1 起存在]

该属性确定当点击语言键时是否会显示弹出列表。如果此属性为 false，则点击语言键将逐个循环显示可用的语言。

默认值为 false。

此属性在 QtQuick.VirtualKeyboard.Styles 2.1 中引入。


modeKeyPanel : Component

通用模式键模板。

此模板提供了一种对状态开或关的键的视觉呈现。此模板用于键标签在不同状态下的显示文本保持不变的情况。

当前状态在 control.mode 属性中可用。

注意： 代理必须基于键面板类型。


导航高亮项模板。

此项目用于在 箭头键导航 模式下高亮键盘上的导航焦点。

此项目通常是一个具有高对比度边框的透明矩形。

此属性自 QtQuick.VirtualKeyboard.Styles 1.1 起存在。


popupListAdd : Transition [自 QtQuick.VirtualKeyboard.Styles 2.1 起存在]

此属性保留应用于添加到弹出列表视图中项的过渡。

此属性在 QtQuick.VirtualKeyboard.Styles 2.1 中引入。


popupListBackground : Component [自 QtQuick.VirtualKeyboard.Styles 2.1 起存在]

弹出列表背景模板。

此属性在 QtQuick.VirtualKeyboard.Styles 2.1 中引入。


popupListDelegate : Component [自 QtQuick.VirtualKeyboard.Styles 2.1 起存在]

弹出列表项模板。

注意：该委托在 ListView 中使用。

注意：委托必须基于 SelectionListItem 类型。

以下属性可用于项

  • display 当前项的显示文本。
  • wordCompletionLength 从显示文本末尾测量的词完成长度。
  • dictionary 词的字典类型，参见 QVirtualKeyboardSelectionListModel::DictionaryType。
  • canRemoveSuggestion 一个布尔值，表示是否可以从字典中删除这个词。

此属性在 QtQuick.VirtualKeyboard.Styles 2.1 中引入。


popupListHighlight : Component [自 QtQuick.VirtualKeyboard.Styles 2.1 起存在]

弹出列表高亮模板。

注意：该委托用作 ListView.highlight。

此属性在 QtQuick.VirtualKeyboard.Styles 2.1 中引入。


popupListRemove : Transition [自 QtQuick.VirtualKeyboard.Styles 2.1 起存在]

此属性保留应用于从弹出列表视图中删除的项的过渡。

此属性在 QtQuick.VirtualKeyboard.Styles 2.1 中引入。


scaleHint : real [只读]

键盘样式缩放提示。此值是通过将 keyboardHeight 除以 keyboardDesignHeight 得到的。所有像素尺寸都必须与该值成比例。


selectionHandle : Component [自 QtQuick.VirtualKeyboard.Styles 2.1 起存在]

此项目用于指示文本选择范围的边界，以及能够交互式地移动选择的开头或结尾。相同的项目用于开头和结尾选择。

当前仅支持基于应用的集成方法的精选处理。

此属性在 QtQuick.VirtualKeyboard.Styles 2.1 中引入。


selectionListAdd : 过渡 [自 QtQuick.VirtualKeyboard.Styles 1.3 开始]

此属性包含应用于添加到精选列表视图的项的过渡。

此属性是在 QtQuick.VirtualKeyboard.Styles 1.3 中引入的。


selectionListBackground : 组件

选择列表背景模板。


selectionListDelegate : 组件

选择列表项模板。

注意：该委托在 ListView 中使用。

注意：委托必须基于 SelectionListItem 类型。

以下属性可用于项

  • display 当前项的显示文本。
  • wordCompletionLength 从显示文本末尾测量的词完成长度。
  • dictionary 词的字典类型，参见 QVirtualKeyboardSelectionListModel::DictionaryType。
  • canRemoveSuggestion 一个布尔值，表示是否可以从字典中删除这个词。

selectionListHeight : 实数

选择列表高度。


selectionListHighlight : 组件

选择列表高亮模板。

注意：该委托用作 ListView.highlight。


selectionListRemove : 过渡 [自 QtQuick.VirtualKeyboard.Styles 1.3 开始]

此属性包含应用于从选择列表视图中删除的项的过渡。

此属性是在 QtQuick.VirtualKeyboard.Styles 1.3 中引入的。


shiftKeyPanel : 组件

shift 键模板。

注意： 代理必须基于键面板类型。


spaceKeyPanel : 组件

空格键模板。

注意： 代理必须基于键面板类型。


symbolKeyPanel : 组件

符号模式键模板。

注意： 代理必须基于键面板类型。


traceCanvasDelegate : 组件 [自 QtQuick.VirtualKeyboard.Styles 2.1 开始]

用于渲染 Trace 对象的模板。

注意：代理必须基于 TraceCanvas 类型。

此属性在 QtQuick.VirtualKeyboard.Styles 2.1 中引入。


traceInputKeyPanelDelegate : 组件 [自 QtQuick.VirtualKeyboard.Styles 2.1 开始]

迹输入键模板。

注意：代理必须基于 TraceInputKeyPanel 类型。

此属性在 QtQuick.VirtualKeyboard.Styles 2.1 中引入。


© 2024 Qt 公司 Ltd。所包含的文档贡献是各自所有者的版权。本文档是根据自由软件基金会发布的 GNU 自由文档许可协议版本 1.3 许可的。Qt 及其相应的标志是芬兰和其他国家/地区的 Qt 公司 Ltd 的商标。所有其他商标均为其各自所有者的财产。