QML自定义列表类实现：如何避免大数组拷贝并兼容原生数组访问

当然可以实现你想要的效果！核心思路是创建一个继承自QObject的包装类，它持有原始基础类型数组的指针，仅在QML访问元素时才将单个元素转换为QVariant，完全避免整个数组的拷贝。同时通过元对象系统暴露必要的接口，让QML能像访问普通数组一样使用它。

步骤1：实现模板化的数组包装类 #

因为你需要支持多种基础类型（uint8_t、float等），用模板类可以避免重复写代码。这个类需要：

• 持有原始数组的指针和长度
• 暴露count属性让QML知道数组长度
• 实现operator[]作为Q_INVOKABLE方法，在访问时按需转换元素为QVariant

#include <QObject>
#include <QVariant>

template<typename T>
class RawArrayWrapper : public QObject
{
    Q_OBJECT
    // 暴露count属性，QML可以通过array.count获取长度
    Q_PROPERTY(int count READ count CONSTANT)

public:
    // 构造函数：传入原始数组指针和长度，注意数组生命周期要长于包装类
    explicit RawArrayWrapper(const T* raw_data, int array_size, QObject* parent = nullptr)
        : QObject(parent), m_raw_data(raw_data), m_size(array_size) {}

    int count() const { return m_size; }

    // 实现operator[]，按需转换单个元素为QVariant
    Q_INVOKABLE QVariant operator[](int index) {
        // 边界检查
        if (index < 0 || index >= m_size) {
            return QVariant();
        }
        // 仅当QML访问时，才将单个元素转换为QVariant
        return QVariant::fromValue(m_raw_data[index]);
    }

private:
    const T* m_raw_data;
    int m_size;
};

步骤2：注册包装类到QML #

针对你需要支持的每种基础类型，注册对应的包装类实例到QML系统。比如：

#include <QQmlEngine>

// 注册uint8_t数组的包装类
qmlRegisterType<RawArrayWrapper<uint8_t>>("CustomArrays", 1, 0, "UInt8Array");
// 注册float数组的包装类
qmlRegisterType<RawArrayWrapper<float>>("CustomArrays", 1, 0, "FloatArray");
// 其他类型同理，比如uint16_t、double等
qmlRegisterType<RawArrayWrapper<uint16_t>>("CustomArrays", 1, 0, "UInt16Array");
qmlRegisterType<RawArrayWrapper<double>>("CustomArrays", 1, 0, "DoubleArray");

步骤3：在C++中创建包装类实例并传递给QML #

假设你有一个uint8_t类型的数组，你可以这样创建包装类并传递给QML：

// 示例：原始数组（注意要确保它的生命周期长于QML中的包装类实例）
uint8_t my_raw_array[] = {0x01, 0x02, 0x03, 0x04};
int array_size = sizeof(my_raw_array) / sizeof(uint8_t);

// 创建包装类实例
auto array_wrapper = new RawArrayWrapper<uint8_t>(my_raw_array, array_size, engine.rootContext());

// 将包装类实例暴露给QML
engine.rootContext()->setContextProperty("myUint8Array", array_wrapper);

步骤4：在QML中像普通数组一样使用 #

现在你可以在QML中直接用方括号访问元素，完全和QVariantList一样：

import CustomArrays 1.0

Rectangle {
    Text {
        // 访问数组第一个元素
        text: "First element: " + myUint8Array[0]
    }

    Component.onCompleted: {
        // 遍历数组
        for (let i = 0; i < myUint8Array.count; i++) {
            console.log("Element at index", i, ":", myUint8Array[i]);
        }
    }
}

为什么之前的Q_INVOKABLE operator[]无效？ #

你之前尝试的方法可能遇到了这几个问题：

1. 返回类型错误：如果你的operator[]直接返回原始类型（比如uint8_t），QML无法识别，必须返回QVariant。
2. 未注册类型：包装类没有通过qmlRegisterType注册到QML系统，QML无法识别该类型的接口。
3. 边界检查缺失：如果索引越界，可能导致未定义行为，QML会静默失败。

额外注意事项 #

• 生命周期管理：包装类持有原始数组的指针，必须确保原始数组的生命周期长于包装类实例。如果数组是动态分配的，可以考虑用std::shared_ptr来管理，避免悬空指针。
• 支持遍历：如果需要QML的for...of循环，可以给包装类添加keys()方法，返回包含所有索引的QVariantList：

  Q_INVOKABLE QVariantList keys() const {
      QVariantList list;
      for (int i = 0; i < m_size; i++) {
          list.append(i);
      }
      return list;
  }
  

  这样QML中就可以写：

  for (let index of myUint8Array.keys()) {
      console.log(myUint8Array[index]);
  }
  

• 结构体数组扩展：如果你的场景是结构体数组（比如你例子中的poses数组），只需要把模板类型换成结构体，并且确保结构体已经注册到QML（用qmlRegisterType或Q_DECLARE_METATYPE）。

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