QQmlListReference Class

QQmlListReference ref1(object, "children");

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

Documentation des fonctions membres

QQmlListReference::QQmlListReference()

Construit une instance invalide.

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

Construit une QQmlListReference à partir d'un QVariant variant contenant un QQmlListProperty. Si variant ne contient pas de propriété de liste, une QQmlListReference invalide est créée. Si l'objet possédant la propriété de liste est détruit après la construction de la référence, celle-ci devient automatiquement invalide. En d'autres termes, il n'y a aucun risque à conserver des instances de QQmlListReference même après la suppression de l'objet.

Cette fonction a été introduite dans Qt 6.1.

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

Construit une QQmlListReference pour object's property. Si property n'est pas une propriété de liste, une QQmlListReference invalide est créée. Si object est détruit après la construction de la référence, celle-ci devient automatiquement invalide. En d'autres termes, il n'y a aucun risque à conserver des instances de QQmlListReference même après la suppression de object.

bool QQmlListReference::append(QObject *object) const

Ajoute object à la liste. Retourne true si l'opération a réussi, sinon false.

Voir aussi canAppend().

QObject *QQmlListReference::at(qsizetype index) const

Renvoie l'élément de la liste à index, ou nullptr si l'opération a échoué.

Voir aussi canAt().

bool QQmlListReference::canAppend() const

Retourne true si la propriété de la liste peut être ajoutée, sinon false. Renvoie false si la référence n'est pas valide.

Voir également append().

bool QQmlListReference::canAt() const

Retourne true si la propriété liste peut être interrogée par index, sinon false. Retourne false si la référence n'est pas valide.

Voir aussi at().

bool QQmlListReference::canClear() const

Retourne true si la propriété list peut être effacée, sinon false. Retourne false si la référence n'est pas valide.

Voir également clear().

bool QQmlListReference::canCount() const

Retourne true si la propriété list peut être interrogée sur le nombre d'éléments, sinon false. Renvoie false si la référence n'est pas valide.

Voir également count().

bool QQmlListReference::canRemoveLast() const

Retourne true si le dernier élément peut être retiré de la propriété de la liste, sinon false. Retourne false si la référence n'est pas valide.

Voir également removeLast().

bool QQmlListReference::canReplace() const

Retourne true si les éléments de la propriété list peuvent être remplacés, sinon false. Retourne false si la référence n'est pas valide.

Voir également replace().

bool QQmlListReference::clear() const

Efface la liste. Retourne true si l'opération a réussi, sinon false.

Voir aussi canClear().

qsizetype QQmlListReference::count() const

Renvoie le nombre d'éléments de la liste, ou 0 si l'opération a échoué.

bool QQmlListReference::isManipulable() const

Retourne vrai si at(), count(), append(), et clear() ou removeLast() sont implémentés, afin que vous puissiez manipuler la liste.

Notez que replace() et removeLast() peuvent être émulés en cachant tous les éléments et en reconstruisant la liste à l'aide de clear() et append(). Ils ne sont donc pas nécessaires pour que la liste soit manipulable. En outre, clear() peut être émulé en utilisant removeLast().

Voir également isReadable(), at(), count(), append(), clear(), replace() et removeLast().

bool QQmlListReference::isReadable() const

Retourne vrai si at() et count() sont implémentés, afin que vous puissiez accéder aux éléments.

Voir aussi isManipulable(), at() et count().

bool QQmlListReference::isValid() const

Retourne true si l'instance fait référence à une propriété de liste valide, sinon false.

const QMetaObject *QQmlListReference::listElementType() const

Renvoie l'adresse QMetaObject pour les éléments stockés dans la propriété de la liste, ou nullptr si la référence n'est pas valide.

Le QMetaObject peut être utilisé à l'avance pour déterminer si une instance donnée peut être ajoutée à une liste. Si vous n'avez pas transmis de moteur lors de la construction, il se peut que le résultat soit nullptr.

QObject *QQmlListReference::object() const

Renvoie l'objet de la propriété de la liste. Retourne nullptr si la référence n'est pas valide.

bool QQmlListReference::removeLast() const

Supprime le dernier élément de la liste. Retourne true si l'opération a réussi, sinon false.

Voir également canRemoveLast().

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

Remplace l'élément situé à index dans la liste par object. Retourne true si l'opération a réussi, sinon false.

Voir aussi canReplace().

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

Renvoie le nombre d'éléments de la liste, ou 0 si l'opération a échoué.

Cette fonction a été introduite dans Qt 6.2.

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

Compare ce QQmlListReference à other et renvoie true s'ils sont égaux. Les deux ne sont considérés comme égaux que si l'un a été créé à partir de l'autre via une affectation ou une construction de copie.