QQmlListReference Class

QQmlListReference ref1(object, "children");

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

Documentation des fonctions membres

QQmlListReference::QQmlListReference()

Crée une instance non valide.

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

Construit un objet `QQmlListReference` à partir d’un ` QVariant ` variant contenant un ` QQmlListProperty`. Si ` variant ` ne contient pas de propriété `list`, un objet `QQmlListReference` non valide est créé. Si l’objet possédant la propriété `list` est détruit après la construction de la référence, celle-ci deviendra automatiquement non valide. Autrement dit, il est possible de conserver des instances de `QQmlListReference` en toute sécurité, 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)

Crée une instance de `QQmlListReference` pour la propriété ` property` de ` object`. Si ` property ` n'est pas une propriété de liste, une instance `QQmlListReference` non valide est créée. Si ` object ` est détruit après la création de la référence, celle-ci deviendra automatiquement invalide. Autrement dit, il est possible de conserver en toute sécurité des instances de `QQmlListReference` même après la suppression de ` object `.

bool QQmlListReference::append(QObject *object) const

Ajoute object à la liste. Renvoie « 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 à l'adresse index, ou nullptr si l'opération a échoué.

Voir également canAt().

bool QQmlListReference::canAppend() const

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

Voir aussi append().

bool QQmlListReference::canAt() const

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

Voir aussi at().

bool QQmlListReference::canClear() const

Renvoie « true » si la propriété « list » peut être vidée, sinon « false ». Renvoie « false » si la référence n'est pas valide.

Voir aussi clear().

bool QQmlListReference::canCount() const

Renvoie « true » si le nombre d'éléments de la propriété « list » peut être obtenu, sinon « false ». Renvoie « false » si la référence n'est pas valide.

Voir également count().

bool QQmlListReference::canRemoveLast() const

Renvoie « true » si le dernier élément peut être supprimé de la propriété « list », sinon « false ». Renvoie « false » si la référence n'est pas valide.

Voir aussi removeLast().

bool QQmlListReference::canReplace() const

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

Voir aussi replace().

bool QQmlListReference::clear() const

Efface la liste. Renvoie « 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

Renvoie « true » si les méthodes at(), count(), append() et soit clear(), soit removeLast() sont implémentées, ce qui vous permet de manipuler la liste.

Notez que les méthodes replace() et removeLast() peuvent être émulées en enregistrant tous les éléments puis en reconstruisant la liste à l’aide de clear() et append(). Elles ne sont donc pas indispensables pour pouvoir manipuler la liste. De plus, la méthode clear() peut être émulée à l’aide de removeLast().

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

bool QQmlListReference::isReadable() const

Renvoie « true » si les méthodes at() et count() sont implémentées, ce qui vous permet d'accéder aux éléments.

Voir également isManipulable(), at() et count().

bool QQmlListReference::isValid() const

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

const QMetaObject *QQmlListReference::listElementType() const

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

L'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 passé de moteur lors de la construction, cette fonction peut renvoyer nullptr.

QObject *QQmlListReference::object() const

Renvoie l'objet de la propriété « list ». Renvoie « nullptr » si la référence n'est pas valide.

bool QQmlListReference::removeLast() const

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

Voir aussi canRemoveLast().

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

Remplace l'élément de la liste situé à l'adresse index par object. Renvoie « true » si l'opération a réussi, sinon « false ».

Voir également 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 cet objet 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 par une affectation par copie ou une construction par copie.