Qt 5.12.9中Q_GADGET类配合QML数据展示异常求助

针对Qt 5.12.9无法展示Q_GADGET模型列表数据的问题，核心是两个版本对Q_GADGET在QML模型场景中的支持存在差异，主要集中在以下几个点：

• 元类型注册不完整
  Qt 5.12对自定义Q_GADGET类型的元类型注册要求更严格。如果你的SectionModel、DescriptionValueModel这类嵌套GADGET类型没有完成以下操作，QML无法识别列表中的元素：

  1. 在类声明后添加Q_DECLARE_METATYPE(SectionModel)、Q_DECLARE_METATYPE(QList<SectionModel>)，所有嵌套GADGET类型都需要对应声明；
  2. 在初始化代码中调用qmlRegisterUncreatableType<SectionModel>("YourModule", 1, 0, "SectionModel", "Cannot create SectionModel in QML")，对所有嵌套类型执行相同注册。
     Qt 5.15可能自动处理了部分元类型注册逻辑，因此无需显式操作也能正常工作。

• 列表属性的Q_PROPERTY声明问题
  如果SupportModel中的列表属性（比如sections）直接用QList<SectionModel>声明，Qt 5.12的QML引擎无法将其识别为可遍历的模型数据源。需要将属性类型改为QVariantList，并在赋值时把QList<SectionModel>逐个转换为QVariant存入列表：

  // SupportModel中修改属性声明
  Q_PROPERTY(QVariantList sections READ sections CONSTANT)
  // 实现读取方法
  QVariantList SupportModel::sections() const {
      QVariantList list;
      for (const auto& section : m_sections) {
          list.append(QVariant::fromValue(section));
      }
      return list;
  }
  

• 代理模型的角色名称处理
  如果InfoPageProxy是继承QAbstractProxyModel的代理类，Qt 5.12要求必须显式重写roleNames()方法，返回正确的角色名称映射。而Qt 5.15可能会自动从源模型的GADGET属性中推导角色名称，无需手动实现：

  QHash<int, QByteArray> InfoPageProxy::roleNames() const {
      QHash<int, QByteArray> roles;
      roles[SectionNameRole] = "sectionName";
      roles[ItemsRole] = "items";
      // 补充其他需要暴露的角色
      return roles;
  }
  

• QML中模型的遍历方式限制
  Qt 5.12的QML引擎不支持直接将QList<Q_GADGET>作为ListView的model属性，必须通过QAbstractItemModel子类包装。如果你的代码在5.15中直接使用GADGET列表作为模型，5.12会无法识别，需要将列表包装成QStandardItemModel或自定义QAbstractListModel子类，把GADGET的属性作为模型角色暴露。

内容的提问来源于stack exchange，提问作者Fausto01