Back to Qt.io
Contact Us Blog Download Qt
在本页

KeyboardStyle QML Type

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

Import Statement: import QtQuick.VirtualKeyboard.Styles
Inherits:

QtObject

属性

详细说明

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

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

属性文档

alternateKeysListBackground : Component

替代键列表背景模板。

alternateKeysListBottomMargin : real

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

alternateKeysListDelegate : Component

替代键列表项的模板。

注意： 委托是在ListView.NET 中使用的。

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]

该属性用于保存全屏输入内容周围的填充。

默认值为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 6.2]

功能弹出列表背景模板。

该属性在 Qt 6.2 中引入。

functionPopupListDelegate : Component [since 6.2]

功能列表项的模板。

注： 委托用于ListView 。

项目可使用以下属性：

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

该属性在 Qt 6.2 中引入。

functionPopupListHighlight : Component [since 6.2]

功能弹出列表高亮模板。

注： 委托被用作ListView.highlight 。

该属性在 Qt 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

键盘的设计高度。

keyboardDesignMaximumHeight : real [since 6.11]

键盘的最大设计高度。

该属性在 Qt 6.11 中引入。

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 中引入。

languagePopupListEnabled : bool [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

移位键的模板。

注意： 委托必须基于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 中引入。

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