QML 序列类型

对于每个对象类型和值类型，都会自动提供一个序列类型来存储该类型的多个实例。您可以使用list 关键字来创建序列类型的属性：

import QtQml

QtObject {
    property list<int> ints: [1, 2, 3, 4]
    property list<Connection> connections: [
        Connection {
            // ...
        },
        Connection {
            // ...
        }
    ]
}

值类型的序列实现为QList ，对象类型的序列实现为QQmlListProperty 。

QML 中的序列一般表现得像 JavaScriptArray 类型，但由于在实现中使用了 C++ 存储类型，所以有一些重要的区别：

1. 从序列中删除一个元素会导致一个默认构造的值取代该元素，而不是undefined 值。
2. 将序列的length 属性设置为大于其当前值的值，将导致序列填充为指定长度的默认构造元素，而不是undefined 元素。
3. Qt XML 容器类支持有符号（而非无符号）整数索引；因此，尝试访问任何大于qsizetype 可容纳最大数量的索引都将失败。

如果您希望从序列中删除元素，而不是简单地用默认构造值替换它们，请不要使用索引删除操作符 (delete sequence[i])，而是使用splice 函数 (sequence.splice(startIndex, deleteCount))。

一般来说，QMetaSequence 可识别的任何容器都可以通过Q_PROPERTY 或Q_INVOKABLE 方法从 C++ 传递到 QML。这包括但不限于所有已注册的QList,QQueue,QStack,QSet, std::list, std::vector 中包含的标有Q_DECLARE_METATYPE 的类型。

通过QMetaSequence 使用序列会导致昂贵的数据转换。为了避免转换，可以使用 C++ 中的QML_SEQUENTIAL_CONTAINER 注册自己的匿名序列类型。以这种方式注册的类型与预定义的序列类型一样，并按原样存储。不过，它们没有 QML 名称。

QtQml 模块包含一些你可能想使用的sequence types 。