QQmlListReference Class

QQmlListReference ref1(object, "children");

const QVariant var = object->property("children");
QQmlListReference ref2(var);

成员函数文档

QQmlListReference::QQmlListReference()

构建了一个无效的实例。

[explicit, since 6.1] QQmlListReference::QQmlListReference(const QVariant &variant)

根据包含QQmlListProperty 的QVariant variant 构建一个QQmlListReference。如果variant 不包含列表属性，则会创建一个无效的QQmlListReference。如果拥有列表属性的对象在引用构建后被销毁，该引用将自动失效。也就是说，即使对象已被删除，保留QQmlListReference实例也是安全的。

该函数于 Qt 6.1 中引入。

QQmlListReference::QQmlListReference(QObject *object, const char *property)

为object 的property 构建一个QQmlListReference。如果property 不是列表属性，则会创建一个无效的QQmlListReference。如果在引用构建后object 被销毁，该引用将自动失效。也就是说，即使在object 被删除后，保留QQmlListReference实例也是安全的。

bool QQmlListReference::append(QObject *object) const

将object 添加到列表中。如果操作成功，则返回 true；否则返回 false。

另请参阅 canAppend()。

QObject *QQmlListReference::at(qsizetype index) const

返回位于index 的列表元素；如果操作失败，则返回nullptr 。

另请参阅 canAt()。

bool QQmlListReference::canAppend() const

如果列表属性支持追加元素，则返回 true；否则返回 false。如果引用无效，则返回 false。

另请参阅 append()。

bool QQmlListReference::canAt() const

如果列表属性可以通过索引进行查询，则返回 true；否则返回 false。如果引用无效，则返回 false。

另请参阅 at()。

bool QQmlListReference::canClear() const

如果列表属性可以被清空，则返回 true；否则返回 false。如果引用无效，则返回 false。

另请参阅 clear()。

bool QQmlListReference::canCount() const

如果可以查询列表属性的元素个数，则返回 true；否则返回 false。如果引用无效，则返回 false。

另请参阅 count()。

bool QQmlListReference::canRemoveLast() const

如果可以从列表属性中移除最后一个元素，则返回 true；否则返回 false。如果引用无效，则返回 false。

另请参阅 removeLast()。

bool QQmlListReference::canReplace() const

如果列表属性中的项目可以被替换，则返回 true；否则返回 false。如果引用无效，则返回 false。

另请参阅 ` replace()`。

bool QQmlListReference::clear() const

清空列表。如果操作成功，则返回 true；否则返回 false。

另请参阅 canClear()。

qsizetype QQmlListReference::count() const

返回列表中的项目个数；如果操作失败，则返回 0。

bool QQmlListReference::isManipulable() const

如果实现了at()、count()、append() 以及clear() 或removeLast() 中的任意一个，则返回 true，这样您就可以对列表进行操作。

请注意，replace() 和removeLast() 可以通过先将所有项目暂存，然后使用clear() 和append() 重建列表来模拟。因此，这些方法并非列表可操作性的必要条件。此外，clear() 也可以通过removeLast() 来模拟。

另请参阅 isReadable()、at()、count()、append()、clear()、replace() 以及removeLast()。

bool QQmlListReference::isReadable() const

如果已实现at() 和count() 方法，则返回 true，以便您可以访问这些元素。

另请参阅 isManipulable()、at() 和count()。

bool QQmlListReference::isValid() const

如果该实例指向一个有效的列表属性，则返回 true；否则返回 false。

const QMetaObject *QQmlListReference::listElementType() const

返回列表属性中存储的元素的QMetaObject ，如果引用无效，则返回nullptr 。

QMetaObject 可预先用于确定给定实例是否可以添加到列表中。如果在构造时未传递引擎，此方法可能会返回 nullptr。

QObject *QQmlListReference::object() const

返回列表属性的对象。如果引用无效，则返回nullptr 。

bool QQmlListReference::removeLast() const

删除列表中的最后一个元素。如果操作成功，则返回 true，否则返回 false。

另请参阅 canRemoveLast()。

bool QQmlListReference::replace(qsizetype index, QObject *object) const

将列表中位于index 的项替换为object 。如果操作成功，则返回 true；否则返回 false。

另请参阅 canReplace()。

[since 6.2] qsizetype QQmlListReference::size() const

返回列表中的项目数量；如果操作失败，则返回 0。

该函数于 Qt 6.2 中引入。

bool QQmlListReference::operator==(const QQmlListReference &other) const

将此对象QQmlListReference 与other 进行比较，若两者相等，则返回true 。只有当其中一个对象是通过复制赋值或复制构造从另一个对象创建而来的时，才认为它们相等。