Qt6之QML——枚举

在 QML 中，枚举 (Enumeration) 是一种用于定义一组固定值的功能。通过枚举，可以便捷地提供一组可选值，使用更加明确和精简。

---

一、枚举的特点

1. 固定值定义： 枚举可以预先定义一组字面值，通常用于需要定义限制值范围的场景。

2. 名称规则：

   • 枚举所在的 QML 文件名必须以大写字汇字段开头。
   • 枚举名自身也必须以大写字汇字段开头。

---

二、枚举使用语法

1. 基本语法

在 QML 中，枚举与其他类型不同，其值需要通过以下语法访问：

1. 通过完整路径访问枚举的值。
2. 在枚举名和值毫无冲突时，可以省略枚举名。

2. 示例

示例1：定义一个基础枚举

以下是一个基本的枚举定义：

// MyEnum.qml
pragma SingletonQtObject {enum MyOptions {OptionA,OptionB,OptionC}
}

在上面的定义中，我们创建了一个名为 MyOptions 的枚举，它包含了 OptionA，OptionB 和 OptionC 三个选项。

示例2：使用枚举

在使用该枚举时，可以通过以下方式来调用：

import QtQuick
Rectangle {width: 200height: 100color: "lightgray"property int currentOption: MyEnum.MyOptions.OptionB // 指定当前选项Text {anchors.centerIn: parenttext: currentOption === MyEnum.MyOptions.OptionA ? "Option A": currentOption === MyEnum.MyOptions.OptionB ? "Option B": "Option C"}Component.onCompleted: {console.log(MyEnum.MyOptions.OptionA)console.log(MyEnum.MyOptions.OptionB)console.log(MyEnum.MyOptions.OptionC)}
}

如下图，通过 MyEnum.MyOptions.OptionB 指定了当前选项，并通过带有条件的文本对应显示了选项名称，同时打印输出三个枚举的对应的值。

示例3：最短访问路径

如果你在上下文中已导入并没有冲突，可以使用最短访问方式：

property int currentOption: MyEnum.OptionC // 省略 MyOptions

---

三、总结

枚举在 QML 中提供了一个实用而明确的方式，用于定义一组固定选项。在实际应用中，通过规范化使用，可以更加显著地提高代码读性和维护性。