BaseKey QML Type

所有密钥类型的通用父类。更多

• 所有成员（包括继承成员）的列表

属性

• active : bool
• alternativeKeys : var
• displayAlternativeKeys : var (since 6.2)
• displayText : string
• effectiveAlternativeKeys : var (since QtQuick.VirtualKeyboard 2.0)
• effectiveAlternativeKeysHighlightIndex : int (since QtQuick.VirtualKeyboard 2.0)
• functionKey : bool
• highlighted : bool
• key : int
• keyPanelDelegate : alias
• keyType : int (since 6.1)
• noKeyEvent : bool (since QtQuick.VirtualKeyboard 1.3)
• noModifier : bool (since QtQuick.VirtualKeyboard 1.3)
• pressed : bool
• repeat : bool
• showPreview : bool
• smallText : string (since QtQuick.VirtualKeyboard 2.0)
• smallTextVisible : bool (since QtQuick.VirtualKeyboard 2.0)
• soundEffect : url (since QtQuick.VirtualKeyboard 1.1)
• text : string
• uppercased : bool
• weight : real

信号

• clicked()

详细说明

BaseKey 是键盘布局中所有按键的通用类型。

布局中不应直接使用此类型。应使用专门的按键类型，如 Key 或EnterKey 。

属性文档

active : bool

该属性表示按键的活动状态。

按键被按下时，该属性会自动设置为 true。

alternativeKeys : var

设置替代键列表。

该属性可以设置为字符串或字符串列表。如果值是字符串，备选键将作为字符串的单个字符显示。如果值是字符串列表，则使用该列表。

用户按住一个设置了该属性的按键，替代键就会显示出来。

默认为空列表。

displayAlternativeKeys : var [since 6.2]

该属性允许重设在替代按键视图中向用户显示的按键字符串列表。

该属性在 Qt 6.2 中引入。

displayText : string

设置显示文本。

该字符串将在键盘布局中显示。

默认值为按键文本。

effectiveAlternativeKeys : var [read-only, since QtQuick.VirtualKeyboard 2.0]

此属性包含提供给用户的有效替代键。

该列表包含alternativeKeys 中的项目，但不包括text 项目。

该属性在 QtQuick.VirtualKeyboard 2.0 中引入。

effectiveAlternativeKeysHighlightIndex : int [read-only, since QtQuick.VirtualKeyboard 2.0]

该属性包含effectiveAlternativeKeys 中高亮显示项目的索引。

该索引由alternativeKeys 中的关键字text 的索引计算得出。

例如，如果备选键包含 "çcċčć"，而键text 是 "c"，则该索引将变为 1，呈现给用户的有效备选键将是 "ç[ċ]čć"。

该属性在 QtQuick.VirtualKeyboard 2.0 中引入。

functionKey : bool

设置功能键属性。

默认值为 false。

highlighted : bool

设置按键的高亮状态。

默认为假。

key : int

设置输入法处理的键代码。

默认值为 Qt.Key_unknown。

keyPanelDelegate : alias

为键设置键面板委托。

该属性对按键装饰至关重要。如果没有按键面板委托，按键是不可见的。此属性应在继承的按键类型中分配。

keyType : int [since 6.1]

Key 专用密钥的类型。可能的值由 {QtVirtualKeyboard::KeyType}{按键类型枚举}定义。

例如，SpaceKey 将此值设置为QtVirtualKeyboard.KeyType.SpaceKey。

此属性在 Qt 6.1 中引入。

noKeyEvent : bool [since QtQuick.VirtualKeyboard 1.3]

该属性控制按键是否发出用于处理输入法的按键事件。为 true 时，按键事件被禁用。

默认情况下，如果按键不是未知的或文本不是空的，按键事件就会发出。

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

noModifier : bool [since QtQuick.VirtualKeyboard 1.3]

禁用发射按键上的按键修饰符。

默认为 false。

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

pressed : bool

该属性用于保存按键的按下状态。

只有当按键处于启用和激活状态时，按下状态才会为真。当按键状态变为按下时，会触发输入引擎的按键按下事件。当按键被释放时，将触发按键上升事件。

repeat : bool

设置按键重复属性。

如果启用重复，按键将在按住时重复输入事件。如果同时设置了alternativeKeys ，则不应使用重复。

默认值为假。

showPreview : bool

设置显示预览属性。

默认情况下，功能键不显示字符预览弹出窗口。

smallText : string [since QtQuick.VirtualKeyboard 2.0]

设置按键角落的小文本。

默认值基于有效替代按键中的默认项目。

该属性在 QtQuick.VirtualKeyboard 2.0 中引入。

smallTextVisible : bool [since QtQuick.VirtualKeyboard 2.0]

设置小文本的可见性。

默认值从父代继承。

该属性在 QtQuick.VirtualKeyboard 2.0 中引入。

soundEffect : url [read-only, since QtQuick.VirtualKeyboard 1.1]

该属性用于保存按键时播放的音效。

该属性为只读，因为音效是在键盘样式中定义的。

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

text : string

设置输入法处理的按键文本。

在大多数情况下，这是按键代码的 Unicode 表示形式。

默认值为空字符串。

uppercased : bool

该属性显示按键的大写状态。

默认情况下，该属性反映键盘的大写状态。

weight : real

设置按键权重值，该值决定按键的相对大小。

使用此属性可更改布局中键的大小。

默认值从布局层次中键的父元素继承。

信号文档

clicked()

按键被按下时触发该信号，允许对按键进行自定义处理。