KeyboardStyle QML Type

为虚拟键盘提供样式界面。更多

Import Statement: import QtQuick.VirtualKeyboard.Styles
Inherits:

QtObject

属性

详细说明

样式类型提供样式定义,供InputPanel 用来装饰虚拟键盘。

设计尺寸指定虚拟键盘的宽高比。样式可根据scaleHint 进行缩放,而 是根据键盘的实际高度和设计高度计算得出的。

属性文档

alternateKeysListBackground : Component

替代按键列表背景模板。


alternateKeysListBottomMargin : real

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


alternateKeysListDelegate : Component

替代按键列表项的模板。

注: 委托用于ListView


alternateKeysListHighlight : Component

备用键列表高亮模板。

注: 该委托用于ListView.highlight


alternateKeysListItemHeight : real

备用键列表项的高度。


alternateKeysListItemWidth : real

备用键列表项的宽度。


alternateKeysListLeftMargin : real

备用键列表面板的左侧边距。


alternateKeysListRightMargin : real

备用按键列表面板的右边距。


alternateKeysListTopMargin : real

备用键列表面板的顶部边距。


backspaceKeyPanel : Component

退格键的模板。

注意: 委托必须基于KeyPanel 类型。


characterPreviewDelegate : Component

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

如果委托包含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 : real

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


enterKeyPanel : Component

回车键的模板。

注意: 委托必须基于KeyPanel 类型。


fullScreenInputBackground : Component [since QtQuick.VirtualKeyboard.Styles 2.2]

该属性用于保存全屏输入背景的委托。

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


fullScreenInputColor : color [since QtQuick.VirtualKeyboard.Styles 2.2]

该属性用于保存全屏输入框的文本颜色。

默认颜色为黑色。

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


fullScreenInputContainerBackground : Component [since QtQuick.VirtualKeyboard.Styles 2.2]

该属性用于保存全屏输入容器背景的委托。

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


fullScreenInputCursor : Component [since QtQuick.VirtualKeyboard.Styles 2.2]

该属性用于保存全屏输入框中光标的委托。

该委托应根据为全屏输入框定义的parent.blinkStatus 属性来切换光标的可见性。例如

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

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


fullScreenInputFont : font [since QtQuick.VirtualKeyboard.Styles 2.2]

该属性用于保存全屏输入框的font

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


fullScreenInputMargins : real [since QtQuick.VirtualKeyboard.Styles 2.2]

该属性用于保存全屏输入框的边距。

默认值为0

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


fullScreenInputPadding : real [since QtQuick.VirtualKeyboard.Styles 2.2]

该属性保存全屏输入内容周围的 padding。

默认值为0

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


fullScreenInputPasswordCharacter : string [since QtQuick.VirtualKeyboard.Styles 2.2]

该属性用于保存全屏输入框的密码掩码字符。

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


fullScreenInputSelectedTextColor : color [since QtQuick.VirtualKeyboard.Styles 2.2]

该属性用于保存全屏输入框的选定文本颜色。

默认颜色设置为fullScreenInputColor

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


fullScreenInputSelectionColor : color [since QtQuick.VirtualKeyboard.Styles 2.2]

该属性用于保存全屏输入框的选择颜色。

默认颜色为半透明黑色。

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


functionPopupListBackground : Component [since QtQuick.VirtualKeyboard.Styles 6.2]

功能弹出列表背景模板。

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


functionPopupListDelegate : Component [since QtQuick.VirtualKeyboard.Styles 6.2]

功能列表项模板。

注: 委托用于ListView

项目可使用以下属性:

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

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


functionPopupListHighlight : Component [since QtQuick.VirtualKeyboard.Styles 6.2]

功能弹出列表高亮模板。

注: 委托被用作ListView.highlight

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


handwritingKeyPanel : Component

手写模式键的模板。

注: 委托必须基于KeyPanel 类型。


hideKeyPanel : Component

隐藏键的模板。

注: 委托必须基于KeyPanel 类型。


keyPanel : Component

常规键模板。

注意: 委托必须基于KeyPanel 类型。

示例:

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

keyboardBackground : Component

键盘背景模板。

示例:键盘背景模板:

keyboardBackground: Rectangle {
    color: "black"
}

keyboardDesignHeight : real

键盘的设计高度。


keyboardDesignWidth : real

键盘的设计宽度。


keyboardHeight : real

键盘的当前高度。


keyboardRelativeBottomMargin : real

最底部按键与键盘容器底部边缘之间的距离,以键盘高度的百分比 (0.0 -1.0) 表示。


keyboardRelativeLeftMargin : real

最左侧按键与键盘左边缘之间的距离,以 (0.0 -1.0) 键盘宽度的百分比表示。


keyboardRelativeRightMargin : real

最右按键与键盘右边缘之间的距离,以 (0.0 -1.0) 键盘宽度的百分比表示。

该值与键盘宽度成正比。


keyboardRelativeTopMargin : real

最顶部按键与键盘顶部边缘之间的距离,以 (0.0 -1.0) 键盘高度的百分比表示。


languageKeyPanel : Component

语言键模板。

注: 委托必须基于KeyPanel 类型。


languageListAdd : Transition [since QtQuick.VirtualKeyboard.Styles 2.1]

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

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


languageListBackground : Component [since QtQuick.VirtualKeyboard.Styles 2.1]

语言列表背景模板。

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


languageListDelegate : Component [since QtQuick.VirtualKeyboard.Styles 2.1]

语言列表项的模板。

注: 该委托用于ListView

注: 委托必须基于SelectionListItem 类型。

该项目具有以下属性:

  • displayName 语言的显示名称。

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


languageListHighlight : Component [since QtQuick.VirtualKeyboard.Styles 2.1]

语言列表高亮模板。

注: 委托被用作ListView.highlight

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


languageListRemove : Transition [since QtQuick.VirtualKeyboard.Styles 2.1]

该属性用于保存从语言列表视图中移除的项目的过渡。

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


languagePopupListEnabledbool[since QtQuick.VirtualKeyboard.Styles 2.1]

该属性决定点击语言键时是否显示弹出列表。如果该属性为false ,则单击语言键会逐次循环显示可用语言。

默认值为false

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


modeKeyPanel : Component

通用模式键模板。

该模板提供了一个可视化按键,其状态可以是开或关。该模板用于无论状态如何,按键标签都保持不变的情况。

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

注意: 委托必须基于KeyPanel 类型。


导航高亮项模板。

该项目在方向键导航模式下用于突出显示键盘上的导航焦点。

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

该属性在 QtQuick.VirtualKeyboard.Styles 1.1 中引入。


popupListAdd : Transition [since QtQuick.VirtualKeyboard.Styles 2.1]

该属性用于保存添加到弹出列表视图中的项目的过渡效果。

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


popupListBackground : Component [since QtQuick.VirtualKeyboard.Styles 2.1]

弹出列表背景模板。

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


popupListDelegate : Component [since QtQuick.VirtualKeyboard.Styles 2.1]

弹出列表项的模板。

注: 该委托用于ListView

注: 委托必须基于SelectionListItem 类型。

项目可使用以下属性:

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

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


popupListHighlight : Component [since QtQuick.VirtualKeyboard.Styles 2.1]

弹出列表高亮模板。

注: 委托被用作ListView.highlight

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


popupListRemove : Transition [since QtQuick.VirtualKeyboard.Styles 2.1]

该属性用于保存从弹出列表视图中移除的项目的过渡。

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


scaleHint : real [read-only]

键盘样式比例提示。该值由keyboardHeight 除以keyboardDesignHeight 得出。所有像素尺寸必须与此值成比例。


selectionHandle : Component [since QtQuick.VirtualKeyboard.Styles 2.1]

该项用于指示文本选区的边界位置,并能以交互方式移动选区的起点或终点。开始和结束选择都使用相同的项目。

选择句柄目前仅支持基于应用程序的集成方法

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


selectionListAdd : Transition [since QtQuick.VirtualKeyboard.Styles 1.3]

该属性保留了应用于添加到选择列表视图中的项的过渡。

该属性在 QtQuick.VirtualKeyboard.Styles 1.3 中引入。


selectionListBackground : Component

选择列表背景模板。


selectionListDelegate : Component

选择列表项的模板。

注: 委托用于ListView

注: 委托必须基于SelectionListItem 类型。

项目可使用以下属性:

  • display 当前项目的显示文本。
  • wordCompletionLength 从显示文本末尾开始测量的单词完成长度。
  • dictionary 单词的字典类型,请参阅 。QVirtualKeyboardSelectionListModel::DictionaryType
  • canRemoveSuggestion 表示是否可以从字典中删除该词的布尔值。

selectionListHeight : real

选择列表高度。


selectionListHighlight : Component

选择列表高亮模板。

注: 委托用作ListView.highlight


selectionListRemove : Transition [since QtQuick.VirtualKeyboard.Styles 1.3]

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

该属性在 QtQuick.VirtualKeyboard.Styles 1.3 中引入。


shiftKeyPanel : Component

用于 shift 键的模板。

注意: 委托必须基于KeyPanel 类型。


spaceKeyPanel : Component

空格键模板。

注: 委托必须基于KeyPanel 类型。


symbolKeyPanel : Component

符号模式键模板。

注: 委托必须基于KeyPanel 类型。


traceCanvasDelegate : Component [since QtQuick.VirtualKeyboard.Styles 2.1]

渲染跟踪对象的模板。

注意: 委托必须基于TraceCanvas 类型。

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


traceInputKeyPanelDelegate : Component [since QtQuick.VirtualKeyboard.Styles 2.1]

跟踪输入键的模板。

注: 委托必须基于TraceInputKeyPanel 类型。

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


© 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.