KeyboardStyle QML Type
为虚拟键盘提供样式界面。更多
Import Statement: | import QtQuick.VirtualKeyboard.Styles |
Inherits: |
属性
- alternateKeysListBackground : Component
- alternateKeysListBottomMargin : real
- alternateKeysListDelegate : Component
- alternateKeysListHighlight : Component
- alternateKeysListItemHeight : real
- alternateKeysListItemWidth : real
- alternateKeysListLeftMargin : real
- alternateKeysListRightMargin : real
- alternateKeysListTopMargin : real
- backspaceKeyPanel : Component
- characterPreviewDelegate : Component
- characterPreviewMargin : real
- enterKeyPanel : Component
- fullScreenInputBackground : Component
(since QtQuick.VirtualKeyboard.Styles 2.2)
- fullScreenInputColor : color
(since QtQuick.VirtualKeyboard.Styles 2.2)
- fullScreenInputContainerBackground : Component
(since QtQuick.VirtualKeyboard.Styles 2.2)
- fullScreenInputCursor : Component
(since QtQuick.VirtualKeyboard.Styles 2.2)
- fullScreenInputFont : font
(since QtQuick.VirtualKeyboard.Styles 2.2)
- fullScreenInputMargins : real
(since QtQuick.VirtualKeyboard.Styles 2.2)
- fullScreenInputPadding : real
(since QtQuick.VirtualKeyboard.Styles 2.2)
- fullScreenInputPasswordCharacter : string
(since QtQuick.VirtualKeyboard.Styles 2.2)
- fullScreenInputSelectedTextColor : color
(since QtQuick.VirtualKeyboard.Styles 2.2)
- fullScreenInputSelectionColor : color
(since QtQuick.VirtualKeyboard.Styles 2.2)
- functionPopupListBackground : Component
(since QtQuick.VirtualKeyboard.Styles 6.2)
- functionPopupListDelegate : Component
(since QtQuick.VirtualKeyboard.Styles 6.2)
- functionPopupListHighlight : Component
(since QtQuick.VirtualKeyboard.Styles 6.2)
- handwritingKeyPanel : Component
- hideKeyPanel : Component
- keyPanel : Component
- keyboardBackground : Component
- keyboardDesignHeight : real
- keyboardDesignWidth : real
- keyboardHeight : real
- keyboardRelativeBottomMargin : real
- keyboardRelativeLeftMargin : real
- keyboardRelativeRightMargin : real
- keyboardRelativeTopMargin : real
- languageKeyPanel : Component
- languageListAdd : Transition
(since QtQuick.VirtualKeyboard.Styles 2.1)
- languageListBackground : Component
(since QtQuick.VirtualKeyboard.Styles 2.1)
- languageListDelegate : Component
(since QtQuick.VirtualKeyboard.Styles 2.1)
- languageListHighlight : Component
(since QtQuick.VirtualKeyboard.Styles 2.1)
- languageListRemove : Transition
(since QtQuick.VirtualKeyboard.Styles 2.1)
- languagePopupListEnabled : bool
(since QtQuick.VirtualKeyboard.Styles 2.1)
- modeKeyPanel : Component
- navigationHighlight : Component
(since QtQuick.VirtualKeyboard.Styles 1.1)
- popupListAdd : Transition
(since QtQuick.VirtualKeyboard.Styles 2.1)
- popupListBackground : Component
(since QtQuick.VirtualKeyboard.Styles 2.1)
- popupListDelegate : Component
(since QtQuick.VirtualKeyboard.Styles 2.1)
- popupListHighlight : Component
(since QtQuick.VirtualKeyboard.Styles 2.1)
- popupListRemove : Transition
(since QtQuick.VirtualKeyboard.Styles 2.1)
- scaleHint : real
- selectionHandle : Component
(since QtQuick.VirtualKeyboard.Styles 2.1)
- selectionListAdd : Transition
(since QtQuick.VirtualKeyboard.Styles 1.3)
- selectionListBackground : Component
- selectionListDelegate : Component
- selectionListHeight : real
- selectionListHighlight : Component
- selectionListRemove : Transition
(since QtQuick.VirtualKeyboard.Styles 1.3)
- shiftKeyPanel : Component
- spaceKeyPanel : Component
- symbolKeyPanel : Component
- traceCanvasDelegate : Component
(since QtQuick.VirtualKeyboard.Styles 2.1)
- traceInputKeyPanelDelegate : Component
(since QtQuick.VirtualKeyboard.Styles 2.1)
详细说明
样式类型提供样式定义,供InputPanel 用来装饰虚拟键盘。
设计尺寸指定虚拟键盘的宽高比。样式可根据scaleHint 进行缩放,而 是根据键盘的实际高度和设计高度计算得出的。
属性文档
alternateKeysListBackground : Component |
替代按键列表背景模板。
alternateKeysListBottomMargin : real |
替代按键列表面板的底边距。
alternateKeysListHighlight : Component |
备用键列表高亮模板。
注: 该委托用于ListView.highlight
。
alternateKeysListItemHeight : real |
备用键列表项的高度。
alternateKeysListItemWidth : real |
备用键列表项的宽度。
alternateKeysListLeftMargin : real |
备用键列表面板的左侧边距。
alternateKeysListRightMargin : real |
备用按键列表面板的右边距。
alternateKeysListTopMargin : real |
备用键列表面板的顶部边距。
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 底部之间的像素数。
fullScreenInputBackground : Component |
该属性用于保存全屏输入背景的委托。
该属性在 QtQuick.VirtualKeyboard.Styles 2.2 中引入。
fullScreenInputColor : color |
该属性用于保存全屏输入框的文本颜色。
默认颜色为黑色。
该属性在 QtQuick.VirtualKeyboard.Styles 2.2 中引入。
fullScreenInputContainerBackground : Component |
该属性用于保存全屏输入容器背景的委托。
该属性在 QtQuick.VirtualKeyboard.Styles 2.2 中引入。
fullScreenInputCursor : Component |
该属性用于保存全屏输入框中光标的委托。
该委托应根据为全屏输入框定义的parent.blinkStatus
属性来切换光标的可见性。例如
fullScreenInputCursor: Rectangle { width: 1 color: "#000" visible: parent.blinkStatus }
该属性在 QtQuick.VirtualKeyboard.Styles 2.2 中引入。
fullScreenInputFont : font |
该属性用于保存全屏输入框的font
。
该属性在 QtQuick.VirtualKeyboard.Styles 2.2 中引入。
fullScreenInputMargins : real |
该属性用于保存全屏输入框的边距。
默认值为0
。
该属性在QtQuick.VirtualKeyboard.Styles 2.2中引入。
fullScreenInputPadding : real |
该属性保存全屏输入内容周围的 padding。
默认值为0
。
该属性在 QtQuick.VirtualKeyboard.Styles 2.2 中引入。
fullScreenInputPasswordCharacter : string |
该属性用于保存全屏输入框的密码掩码字符。
该属性在 QtQuick.VirtualKeyboard.Styles 2.2 中引入。
fullScreenInputSelectedTextColor : color |
该属性用于保存全屏输入框的选定文本颜色。
默认颜色设置为fullScreenInputColor
。
该属性在 QtQuick.VirtualKeyboard.Styles 2.2 中引入。
fullScreenInputSelectionColor : color |
该属性用于保存全屏输入框的选择颜色。
默认颜色为半透明黑色。
该属性在 QtQuick.VirtualKeyboard.Styles 2.2 中引入。
functionPopupListBackground : Component |
功能弹出列表背景模板。
该属性在 QtQuick.VirtualKeyboard.Styles 6.2 中引入。
functionPopupListDelegate : Component |
功能列表项模板。
注: 委托用于ListView 。
项目可使用以下属性:
keyboardFunction
- 当前项目的键盘功能。
该属性在 QtQuick.VirtualKeyboard.Styles 6.2 中引入。
functionPopupListHighlight : Component |
功能弹出列表高亮模板。
注: 委托被用作ListView.highlight
。
该属性在QtQuick.VirtualKeyboard.Styles 6.2中引入。
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
) 键盘高度的百分比表示。
languageListAdd : Transition |
该属性包含应用于添加到语言列表视图的项目的过渡。
该属性在 QtQuick.VirtualKeyboard.Styles 2.1 中引入。
languageListBackground : Component |
语言列表背景模板。
该属性在 QtQuick.VirtualKeyboard.Styles 2.1 中引入。
languageListDelegate : Component |
语言列表项的模板。
注: 该委托用于ListView 。
注: 委托必须基于SelectionListItem 类型。
该项目具有以下属性:
displayName
语言的显示名称。
该属性在 QtQuick.VirtualKeyboard.Styles 2.1 中引入。
languageListHighlight : Component |
语言列表高亮模板。
注: 委托被用作ListView.highlight
。
该属性在QtQuick.VirtualKeyboard.Styles 2.1中引入。
languageListRemove : Transition |
该属性用于保存从语言列表视图中移除的项目的过渡。
该属性在 QtQuick.VirtualKeyboard.Styles 2.1 中引入。
languagePopupListEnabled: bool |
该属性决定点击语言键时是否显示弹出列表。如果该属性为false
,则单击语言键会逐次循环显示可用语言。
默认值为false
。
该属性在 QtQuick.VirtualKeyboard.Styles 2.1 中引入。
modeKeyPanel : Component |
通用模式键模板。
该模板提供了一个可视化按键,其状态可以是开或关。该模板用于无论状态如何,按键标签都保持不变的情况。
当前状态可在control.mode
属性中查看。
注意: 委托必须基于KeyPanel 类型。
navigationHighlight : Component |
导航高亮项模板。
该项目在方向键导航模式下用于突出显示键盘上的导航焦点。
该项目通常是一个具有高对比度边框的透明矩形。
该属性在 QtQuick.VirtualKeyboard.Styles 1.1 中引入。
popupListAdd : Transition |
该属性用于保存添加到弹出列表视图中的项目的过渡效果。
该属性在 QtQuick.VirtualKeyboard.Styles 2.1 中引入。
popupListBackground : Component |
弹出列表背景模板。
该属性在QtQuick.VirtualKeyboard.Styles 2.1中引入。
popupListDelegate : Component |
弹出列表项的模板。
注: 该委托用于ListView 。
注: 委托必须基于SelectionListItem 类型。
项目可使用以下属性:
display
当前项目的显示文本。wordCompletionLength
从显示文本末尾开始测量的单词完成长度。dictionary
单词的字典类型,请参阅 。QVirtualKeyboardSelectionListModel::DictionaryTypecanRemoveSuggestion
一个布尔值,表示该词是否可以从字典中删除。
该属性在 QtQuick.VirtualKeyboard.Styles 2.1 中引入。
popupListHighlight : Component |
弹出列表高亮模板。
注: 委托被用作ListView.highlight
。
该属性在QtQuick.VirtualKeyboard.Styles 2.1中引入。
popupListRemove : Transition |
该属性用于保存从弹出列表视图中移除的项目的过渡。
该属性在QtQuick.VirtualKeyboard.Styles 2.1中引入。
scaleHint : real |
键盘样式比例提示。该值由keyboardHeight 除以keyboardDesignHeight 得出。所有像素尺寸必须与此值成比例。
selectionHandle : Component |
该项用于指示文本选区的边界位置,并能以交互方式移动选区的起点或终点。开始和结束选择都使用相同的项目。
选择句柄目前仅支持基于应用程序的集成方法。
该属性在 QtQuick.VirtualKeyboard.Styles 2.1 中引入。
selectionListAdd : Transition |
该属性保留了应用于添加到选择列表视图中的项的过渡。
该属性在 QtQuick.VirtualKeyboard.Styles 1.3 中引入。
selectionListBackground : Component |
选择列表背景模板。
selectionListDelegate : Component |
选择列表项的模板。
注: 委托用于ListView 。
注: 委托必须基于SelectionListItem 类型。
项目可使用以下属性:
display
当前项目的显示文本。wordCompletionLength
从显示文本末尾开始测量的单词完成长度。dictionary
单词的字典类型,请参阅 。QVirtualKeyboardSelectionListModel::DictionaryTypecanRemoveSuggestion
表示是否可以从字典中删除该词的布尔值。
selectionListHeight : real |
选择列表高度。
selectionListHighlight : Component |
选择列表高亮模板。
注: 委托用作ListView.highlight
。
selectionListRemove : Transition |
该属性包含应用于从选择列表视图中移除的项目的过渡。
该属性在 QtQuick.VirtualKeyboard.Styles 1.3 中引入。
traceCanvasDelegate : Component |
traceInputKeyPanelDelegate : Component |
© 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.