Qt的技巧笔记(一)：Qt的QComboBox与自定义的枚举类

​ 枚举类型enum通常用于定义一组固定的常量值，在Qt开发中，QComboBox控件中使用枚举值来设置或获取当前中的选项。如果你想要遍历一个枚举类型，比如在QComboBox中填充所用枚举值，你需要先定义枚举，然后利用Qt的元对象系统(Meta-Object System)来获取枚举的名称和值。

• 步骤1：定义枚举

首先，定义你的枚举，通常这会在一个类中完成例如：

class MyClass : public QObject {
    Q_OBJECT

public:
    enum MyEnum {
        Value1,
        Value2,
        Value3
    };
    Q_ENUM(MyEnum) // 告诉Qt的元对象系统这是一个枚举
};

其中，Q_ENUM 宏将枚举类型定义到元对象系统里，这个宏要定义在枚举后面，并且这个类中要带有Q_OBJECT和Q_GADGET，在命名空间中使用Q_ENUM_NS()来代替。

• 步骤2：遍历枚举并填充到QComboBox控件里

  ​ 通过上述的定义，枚举类型通过Q_ENUM将QMetaEnum注册到QMetaObject中，然后可以使用QMetaEnum::fromType获取QMetaEnum。使用这个宏会自动注册到元对象系统中，可以使用Qt中的QMetaEnum 类来遍历枚举的所有值，并且将其添加到QComboBox中。下面给出如下代码示例：

  #include <QComboBox>
  #include <QMetaEnum>
  #include <QDebug>
  
  void populateComboBoxWithEnum(QComboBox *comboBox, const char *enumName) {
      QMetaObject metaObject = MyClass::staticMetaObject; // 获取MyClass的元对象
      QMetaEnum metaEnum = metaObject.enumerator(metaObject.indexOfEnumerator(enumName)); // 获取枚举信息
      
      for (int i = 0; i < metaEnum.keyCount(); ++i) {
          QString key = metaEnum.key(i); // 获取枚举的键（名称）
          int value = metaEnum.value(i); // 获取枚举的值
          comboBox->addItem(key, value); // 将键和值作为数据添加到comboBox中
      }
  }
  
  

  其主程序：

  int main(int argc, char *argv[]) {
      QApplication app(argc, argv);
      QComboBox comboBox;
      populateComboBoxWithEnum(&comboBox, "MyEnum"); // 调用函数填充comboBox
      comboBox.show();
      return app.exec();
  }
  

  QMetaObject::indexOfEnumerator(const char *name) 是 Qt 框架中的一个方法，用于查找与给定名称匹配的枚举器的索引。这个方法属于 QMetaObject 类，它是 Qt 用于反射（reflection）和元对象系统的一部分。通过这个方法，你可以查询一个类的元对象信息，以获取某个枚举器的索引。

  函数原型

  static int indexOfEnumerator(const char *name);
  

  参数

  • const char *name：一个指向 C 字符串的指针，该字符串包含了要查找的枚举器的名称。

  返回值

  • 返回一个整数，表示找到的枚举器的索引。如果没有找到匹配的枚举器，则返回 -1。

  通过这种方式，你可以在运行时动态地查询和使用类的元数据，这在某些情况下非常有用，特别是在需要根据名称动态访问枚举值时。

  注意事项：

  1. 确保在你的类定义中使用Q_ENUM(MyEnum)宏，这样Qt的元对象系统才能识别并处理这个枚举；
  2. Q_ENUM加持的枚举结构必须是公有的；
  3. populateComboBoxWithEnum函数通过枚举的名称("MyEnum") 来查找对应的枚举，并且通过QMetaEnum遍历其所有项。
  4. 使用comboBox->addItem(key,value)将枚举的名称和值添加到QComboBox中，其中名称显示在界面上，值作为内部数据。你可以通过currentData()方法获取当前选项的内部值。
  5. metaEnum.keyCount(): 返回索引 i 处的枚举成员名称（const char*）。
  6. metaEnum.value(i)：返回索引 i 处的枚举成员对应的整数值。
  7. metaEnum.key(i)：返回索引 i 处的枚举成员名称（const char*）。
  8. QMetaObject::indexOfEnumerator(const char *name) 方法，传入枚举的名称（字符串），获取该枚举在元对象中的索引。
  9. QMetaObject::enumerator() 方法，并通过 QMetaObject::indexOfEnumerator() 方法找到枚举在元对象中的索引。