QQmlListReference Class

QQmlListReference ref1(object, "children");

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

Dokumentation der Member-Funktionen

QQmlListReference::QQmlListReference()

Erzeugt eine ungültige Instanz.

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

Erstellt eine `QQmlListReference` aus einer ` QVariant ` ` variant `, die eine ` QQmlListProperty` enthält. Wenn ` variant ` keine Listen-Eigenschaft enthält, wird eine ungültige `QQmlListReference` erstellt. Wird das Objekt, das die Listen-Eigenschaft besitzt, nach der Erstellung der Referenz zerstört, wird diese automatisch ungültig. Das heißt, es ist unbedenklich, `QQmlListReference`-Instanzen auch nach dem Löschen des Objekts beizubehalten.

Diese Funktion wurde in Qt 6.1 eingeführt.

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

Erstellt eine `QQmlListReference` für ` property` von ` object`. Ist ` property ` keine Listen-Eigenschaft, wird eine ungültige `QQmlListReference` erstellt. Wird ` object ` nach der Erstellung der Referenz zerstört, wird diese automatisch ungültig. Das heißt, es ist unbedenklich, `QQmlListReference`-Instanzen auch nach dem Löschen von ` object ` beizubehalten.

bool QQmlListReference::append(QObject *object) const

Fügt „ object “ zur Liste hinzu. Gibt „true“ zurück, wenn der Vorgang erfolgreich war, andernfalls „false“.

Siehe auch canAppend().

QObject *QQmlListReference::at(qsizetype index) const

Gibt das Listenelement unter index zurück oder nullptr, falls die Operation fehlgeschlagen ist.

Siehe auch canAt().

bool QQmlListReference::canAppend() const

Gibt „true“ zurück, wenn an die Liste-Eigenschaft angehängt werden kann, andernfalls „false“. Gibt „false“ zurück, wenn die Referenz ungültig ist.

Siehe auch ` append()`.

bool QQmlListReference::canAt() const

Gibt „true“ zurück, wenn die Listeigenschaft anhand eines Index abgefragt werden kann, andernfalls „false“. Gibt „false“ zurück, wenn die Referenz ungültig ist.

Siehe auch ` at()`.

bool QQmlListReference::canClear() const

Gibt „true“ zurück, wenn die Liste geleert werden kann, andernfalls „false“. Gibt „false“ zurück, wenn die Referenz ungültig ist.

Siehe auch ` clear()`.

bool QQmlListReference::canCount() const

Gibt „true“ zurück, wenn die Anzahl der Elemente der Liste abgefragt werden kann, andernfalls „false“. Gibt „false“ zurück, wenn die Referenz ungültig ist.

Siehe auch ` count()`.

bool QQmlListReference::canRemoveLast() const

Gibt „true“ zurück, wenn das letzte Element aus der Listen-Eigenschaft entfernt werden kann, andernfalls „false“. Gibt „false“ zurück, wenn die Referenz ungültig ist.

Siehe auch „ removeLast()“.

bool QQmlListReference::canReplace() const

Gibt „true“ zurück, wenn Elemente in der Eigenschaft „list“ ersetzt werden können, andernfalls „false“. Gibt „false“ zurück, wenn die Referenz ungültig ist.

Siehe auch ` replace()`.

bool QQmlListReference::clear() const

Löscht die Liste. Gibt „true“ zurück, wenn der Vorgang erfolgreich war, andernfalls „false“.

Siehe auch ` canClear()`.

qsizetype QQmlListReference::count() const

Gibt die Anzahl der Elemente in der Liste zurück oder 0, falls die Operation fehlgeschlagen ist.

bool QQmlListReference::isManipulable() const

Gibt „true“ zurück, wenn at(), count(), append() sowie entweder clear() oder removeLast() implementiert sind, sodass Sie die Liste bearbeiten können.

Beachten Sie, dass replace() und removeLast() emuliert werden können, indem alle Elemente zwischengespeichert und die Liste mit clear() und append() neu aufgebaut wird. Daher sind sie nicht erforderlich, damit die Liste bearbeitet werden kann. Außerdem kann clear() mit removeLast() emuliert werden.

Siehe auch isReadable(), at(), count(), append(), clear(), replace() und removeLast().

bool QQmlListReference::isReadable() const

Gibt „true“ zurück, wenn „ at()“ und „ count()“ implementiert sind, sodass Sie auf die Elemente zugreifen können.

Siehe auch ` isManipulable()`, ` at()` und ` count()`.

bool QQmlListReference::isValid() const

Gibt „true“ zurück, wenn sich die Instanz auf eine gültige Listen-Eigenschaft bezieht, andernfalls „false“.

const QMetaObject *QQmlListReference::listElementType() const

Gibt den „ QMetaObject “ für die in der Eigenschaft „list“ gespeicherten Elemente zurück oder „ nullptr “, falls die Referenz ungültig ist.

Die ` QMetaObject ` kann vorab verwendet werden, um festzustellen, ob eine bestimmte Instanz einer Liste hinzugefügt werden kann. Wenn beim Erstellen keine Engine übergeben wurde, gibt diese Funktion möglicherweise `nullptr` zurück.

QObject *QQmlListReference::object() const

Gibt das Objekt der Listen-Eigenschaft zurück. Gibt „ nullptr “ zurück, wenn die Referenz ungültig ist.

bool QQmlListReference::removeLast() const

Entfernt das letzte Element aus der Liste. Gibt „true“ zurück, wenn der Vorgang erfolgreich war, andernfalls „false“.

Siehe auch ` canRemoveLast()`.

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

Ersetzt den Eintrag unter index in der Liste durch object. Gibt „true“ zurück, wenn der Vorgang erfolgreich war, andernfalls „false“.

Siehe auch canReplace().

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

Gibt die Anzahl der Elemente in der Liste zurück oder 0, wenn die Operation fehlgeschlagen ist.

Diese Funktion wurde in Qt 6.2 eingeführt.

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

Vergleicht dieses ` QQmlListReference ` mit ` other` und gibt ` true ` zurück, wenn sie gleich sind. Die beiden gelten nur dann als gleich, wenn eines durch eine Kopierzuweisung oder eine Kopierkonstruktion aus dem anderen erstellt wurde.