BaseKey QML 类型

BaseKey QML 类型

BaseKey 是 Qt Quick 中所有按键类型的共同父类。它提供了基本的按键功能和属性，用于在 QML 应用程序中处理键盘输入和创建自定义键盘控件。

属性

基本属性

• key: int - 表示按键的码值，如 Qt.Key_A 或 Qt.Key_Return
• text: string - 表示按键输入时产生的文本
• enabled: bool - 控制按键是否可用
• pressed: bool - 表示按键当前是否被按下
• active: bool - 表示按键是否处于活动状态
• autoRepeat: bool - 设置按键是否支持自动重复
• highlighted: bool - 表示按键是否被高亮显示

视觉属性

• width: real - 按键的宽度
• height: real - 按键的高度
• background: Item - 按键的背景项目

信号

• clicked(): 当按键被点击时触发
• pressedChanged(): 当按键的按下状态改变时触发
• activeChanged(): 当按键的活动状态改变时触发

常见子类

BaseKey 作为基类，有多种专门的按键类型继承自它：

• Key: 基本按键类型
• EnterKey: 回车键
• ShiftKey: Shift键
• SpaceKey: 空格键
• BackspaceKey: 退格键
• FlickKey: 支持滑动手势的按键

使用示例

import QtQuick 2.15
import QtQuick.Controls 2.15
import QtQuick.VirtualKeyboard 2.15

Item {
    width: 300
    height: 200
    
    Key {
        key: Qt.Key_A
        text: "A"
        width: 40
        height: 40
        onClicked: {
            console.log("按键A被点击")
        }
    }
}

定制键盘

通过继承和使用 BaseKey，可以创建自定义键盘布局：

Row {
    Key { key: Qt.Key_Q; text: "Q" }
    Key { key: Qt.Key_W; text: "W" }
    Key { key: Qt.Key_E; text: "E" }
    // 更多按键...
}

BaseKey 是虚拟键盘实现的基础，它为各种类型的按键提供了统一的接口和行为，便于开发者构建自定义键盘和处理键盘输入。