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() 方法找到枚舉在元對象中的索引。