BaseKey QML Type
所有密钥类型的通用父类。更多
Import Statement: | import QtQuick.VirtualKeyboard.Components |
Inherits: | |
Inherited By: | BackspaceKey, ChangeLanguageKey, EnterKey, FillerKey, HideKeyboardKey, Key, and ShiftKey |
属性
- active : bool
- alternativeKeys : var
- displayAlternativeKeys : var
(since QtQuick.VirtualKeyboard 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 QtQuick.VirtualKeyboard 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 |
设置替代按键列表。
该属性可设置为字符串或字符串列表。如果值是字符串,替代按键将以该字符串中单个字符的形式显示。如果值是字符串列表,则使用该列表。
用户按住一个设置了该属性的按键,替代键就会显示出来。
注意: 如果备选按键包含按键text
,它将从effectiveAlternativeKeys
中被过滤掉,其位置将被用作高亮显示项的指示符。
默认为空列表。
displayAlternativeKeys : var |
该属性允许覆盖在替代键视图中显示给用户的键字符串列表。
该属性在 QtQuick.VirtualKeyboard 6.2 中引入。
displayText : string |
设置显示文本。
该字符串将在键盘布局中呈现。
默认值为按键文本。
effectiveAlternativeKeys : var |
该属性包含显示给用户的有效替代按键。
该列表包含alternativeKeys
中的项目,不包括text
项目。
该属性在 QtQuick.VirtualKeyboard 2.0 中引入。
effectiveAlternativeKeysHighlightIndex : int |
该属性包含effectiveAlternativeKeys
中高亮显示项的索引。
该索引由alternativeKeys
中的按键text
的索引计算得出。
例如,如果备选键包含 "çcċčć",而按键text
是 "c",则该索引将变为 1,呈现给用户的有效备选键将是 "ç[ċ]čć"。
此属性在 QtQuick.VirtualKeyboard 2.0 中引入。
functionKey : bool |
设置功能键属性。
默认为 false。
highlighted : bool |
设置按键的高亮状态。
默认为 false。
key : int |
设置输入法处理的按键代码。
默认为 Qt.Key_unknown。
keyPanelDelegate : alias |
为按键设置按键面板委托。
该属性对于按键装饰至关重要。如果没有按键面板委托,按键是不可见的。此属性应在继承的按键类型中指定。
keyType : int |
Key 键的类型。可能的值由 { }{键类型枚举}定义。QtVirtualKeyboard::KeyType
例如,SpaceKey 将此值设置为QtVirtualKeyboard.KeyType.SpaceKey。
该属性在 QtQuick.VirtualKeyboard 6.1 中引入。
noKeyEvent : bool |
该属性控制按键是否发出用于处理输入法的按键事件。为 true 时,按键事件被禁用。
默认情况下,如果按键不未知或文本不为空,则按键事件会被触发。
该属性在 QtQuick.VirtualKeyboard 1.3 中引入。
noModifier : bool |
禁用已发射按键上的按键修饰符。
默认为 false。
该属性在 QtQuick.VirtualKeyboard 1.3 中引入。
pressed : bool |
该属性保存按键的按下状态。
只有当按键处于启用和激活状态时,按下状态才可能为 true。当按键状态变为按下时,会触发输入引擎的按键按下事件。按键松开时会触发按键上升事件。
repeat : bool |
showPreview : bool |
设置显示预览属性。
默认情况下,功能键不显示字符预览弹出窗口。
smallText : string |
设置在按键角落渲染的小文本。
默认值基于有效替代按键中的默认项目。
该属性在 QtQuick.VirtualKeyboard 2.0 中引入。
smallTextVisible : bool |
设置小文本的可见性。
默认值从父代继承。
该属性在 QtQuick.VirtualKeyboard 2.0 中引入。
soundEffect : url |
该属性保存按键时播放的音效。
该属性为只读,因为音效是在键盘样式中定义的。
该属性在 QtQuick.VirtualKeyboard 1.1 中引入。
text : string |
设置输入法处理的按键文本。
在大多数情况下,这是按键代码的 Unicode 表示。
默认值为空字符串。
uppercased : bool |
该属性用于保存按键的大写状态。
默认情况下,该属性反映键盘的大写状态。
weight : real |
设置按键权重值,该值决定按键的相对大小。
使用该属性可更改布局中按键的大小。
默认值从布局层次中按键的父元素继承。
信号文档
clicked() |
该信号在按键被按下时触发,允许对按键进行自定义处理。
注: 相应的处理程序是onClicked
。
© 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.