BaseKey QML 类型

所有键类型的公共父类。更多信息...

导入语句	import QtQuick.VirtualKeyboard.Components
继承自	Item
继承元素	BackspaceKey、ChangeLanguageKey、EnterKey、FillerKey、HideKeyboardKey、Key 和 ShiftKey

所有成员列表，包括继承的成员

属性

active : bool
alternativeKeys : var
displayAlternativeKeys : var (自 QtQuick.VirtualKeyboard 6.2)
displayText : string
effectiveAlternativeKeys : var (自 QtQuick.VirtualKeyboard 2.0)
effectiveAlternativeKeysHighlightIndex : int (自 QtQuick.VirtualKeyboard 2.0)
functionKey : bool
highlighted : bool
key : int
keyPanelDelegate : alias
keyType : int (自 QtQuick.VirtualKeyboard 6.1)
noKeyEvent : bool (自 QtQuick.VirtualKeyboard 1.3)
noModifier : bool (自 QtQuick.VirtualKeyboard 1.3)
pressed : bool
repeat : bool
showPreview : bool
smallText : string (自 QtQuick.VirtualKeyboard 2.0)
smallTextVisible : bool (自 QtQuick.VirtualKeyboard 2.0)
soundEffect : url (自 QtQuick.VirtualKeyboard 1.1)
text : 字符串
uppercased : 布尔
weight : 实数

信号

clicked()

详细描述

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

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

属性文档

active : bool

此属性保存了键的激活状态。

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

alternativeKeys : var

设置替代键列表。

此属性可以是字符串，也可以是字符串列表。如果值是字符串，则替代键作为该字符串的各个字符呈现。如果值为字符串列表，则使用列表。

当按下并保持具有此属性的键时，将向用户呈现替代键。

注意：如果替代键包含 text 键，则它将过滤 effectiveAlternativeKeys 并将其位置用作突出项的指示器。

默认为空列表。

displayAlternativeKeys : var [since QtQuick.VirtualKeyboard 6.2]

此属性允许覆盖用户在替代键视图中呈现的键字符串列表。

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

displayText : string

设置显示文本。

该字符串在键盘布局中渲染。

默认值为键文本。

effectiveAlternativeKeys : var [只读，since QtQuick.VirtualKeyboard 2.0]

此属性包含向用户呈现的有效替代键。

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

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

effectiveAlternativeKeysHighlightIndex : int [只读，since QtQuick.VirtualKeyboard 2.0]

此属性包含 effectiveAlternativeKeys 中突出项的索引。

索引从 alternativeKeys 中的键 text 的索引计算得出。

例如，如果替代键包含 "çcċčć" 且键 text 是 "c"，则此索引将变为 1，并向用户呈现的有效替代键将是 "ç[ċ]čć"。

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

functionKey : bool

设置功能键属性。

默认为 false。

highlighted : bool

设置键的突出显示状态。

默认为 false。

key : int

为输入法处理设置键码。

默认值是 Qt.Key_unknown。

keyPanelDelegate : 别名

为键设置键面板代表。

此属性对于键装饰至关重要。没有键面板代表，键不可见。此属性应该在继承的键类型中分配。

keyType : int [since QtQuick.VirtualKeyboard 6.1]

特定键的类型。可能值由 QtVirtualKeyboard::KeyType（键类型枚举）定义。

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

该属性自 QtQuick.VirtualKeyboard 6.1 版本开始引入。

noKeyEvent : bool [since QtQuick.VirtualKeyboard 1.3]

此属性控制键是否向输入法处理发出键事件。当为 true 时，键事件被禁用。

默认情况下，如果 key 未知或 text 不为空，则发出键事件。

该属性自 QtQuick.VirtualKeyboard 1.3 版本开始引入。

noModifier : bool [since QtQuick.VirtualKeyboard 1.3]

在发出的键上禁用键修饰符。

默认为 false。

该属性自 QtQuick.VirtualKeyboard 1.3 版本开始引入。

pressed : bool

此属性表示键的按下状态。

按下状态只能在键既启用又活动的情况下为 true。当键状态变为按下时，它将触发输入引擎的按键下事件。释放按键时触发按键上事件。

repeat : bool

设置键重复属性。

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

默认为 false。

showPreview : bool

设置 show preview 属性。

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

smallText : string [since QtQuick.VirtualKeyboard 2.0]

设置在键角落绘制的文本书本。

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

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

smallTextVisible : bool [since QtQuick.VirtualKeyboard 2.0]

设置小文本的可见性。

默认值从父级继承。

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

soundEffect : url [只读，since QtQuick.VirtualKeyboard 1.1]

此属性保存要在按键时播放的声音效果。

由于声音效果在键盘样式中定义，因此该属性为只读。

该属性自 QtQuick.VirtualKeyboard 1.1 版本开始引入。

text : string

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

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

默认值为空字符串。

uppercased : bool

此属性表示键的大写状态。

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

weight : real

设置键的重量值，该值确定键的相对大小。

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

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

信号文档

clicked()

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

注意: 对应的处理程序是 onClicked。