QQmlListReference Class

QQmlListReference ref1(object, "children");

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

Documentación de las funciones miembro

QQmlListReference::QQmlListReference()

Construye una instancia inválida.

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

Construye una QQmlListReference a partir de un QVariant variant que contiene un QQmlListProperty. Si variant no contiene una propiedad de lista, se crea una QQmlListReference inválida. Si el objeto que posee la propiedad de lista se destruye después de construir la referencia, ésta dejará de ser válida automáticamente. Es decir, es seguro mantener instancias QQmlListReference incluso después de que el objeto sea eliminado.

Esta función se introdujo en Qt 6.1.

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

Construye una QQmlListReference para object's property. Si property no es una propiedad de lista, se crea una QQmlListReference inválida. Si object se destruye después de construir la referencia, ésta dejará de ser válida automáticamente. Es decir, es seguro mantener instancias QQmlListReference incluso después de que object sea eliminado.

bool QQmlListReference::append(QObject *object) const

Añade object a la lista. Devuelve true si la operación se ha realizado correctamente, en caso contrario false.

Véase también canAppend().

QObject *QQmlListReference::at(qsizetype index) const

Devuelve el elemento de la lista en index, o nullptr si la operación falló.

Véase también canAt().

bool QQmlListReference::canAppend() const

Devuelve true si se puede anexar a la propiedad de la lista, en caso contrario false. Devuelve false si la referencia no es válida.

Véase también append().

bool QQmlListReference::canAt() const

Devuelve true si la propiedad de la lista se puede consultar por índice, en caso contrario false. Devuelve false si la referencia no es válida.

Véase también at().

bool QQmlListReference::canClear() const

Devuelve true si se puede borrar la propiedad de la lista, en caso contrario false. Devuelve false si la referencia no es válida.

Véase también clear().

bool QQmlListReference::canCount() const

Devuelve true si la propiedad list puede ser consultada por su número de elementos, en caso contrario false. Devuelve false si la referencia no es válida.

Véase también count().

bool QQmlListReference::canRemoveLast() const

Devuelve true si el último elemento se puede eliminar de la propiedad list, en caso contrario false. Devuelve false si la referencia no es válida.

Véase también removeLast().

bool QQmlListReference::canReplace() const

Devuelve true si los elementos de la propiedad list pueden ser reemplazados, en caso contrario false. Devuelve false si la referencia no es válida.

Véase también replace().

bool QQmlListReference::clear() const

Borra la lista. Devuelve true si la operación ha tenido éxito, en caso contrario false.

Véase también canClear().

qsizetype QQmlListReference::count() const

Devuelve el número de elementos de la lista, o 0 si la operación ha fallado.

bool QQmlListReference::isManipulable() const

Devuelve true si at(), count(), append(), y clear() o removeLast() están implementados, para que puedas manipular la lista.

Tenga en cuenta que replace() y removeLast() pueden emularse almacenando todos los elementos y reconstruyendo la lista con clear() y append(). Por lo tanto, no son necesarios para que la lista sea manipulable. Además, clear() puede emularse utilizando removeLast().

Véase también isReadable(), at(), count(), append(), clear(), replace() y removeLast().

bool QQmlListReference::isReadable() const

Devuelve true si at() y count() están implementados, por lo que se puede acceder a los elementos.

Véase también isManipulable(), at(), y count().

bool QQmlListReference::isValid() const

Devuelve true si la instancia se refiere a una propiedad de lista válida, en caso contrario false.

const QMetaObject *QQmlListReference::listElementType() const

Devuelve el QMetaObject para los elementos almacenados en la propiedad de la lista, o nullptr si la referencia no es válida.

El QMetaObject se puede utilizar por adelantado para determinar si una instancia dada se puede añadir a una lista. Si no pasaste un motor en la construcción esto puede devolver nullptr.

QObject *QQmlListReference::object() const

Devuelve el objeto de la propiedad list. Devuelve nullptr si la referencia no es válida.

bool QQmlListReference::removeLast() const

Elimina el último elemento de la lista. Devuelve true si la operación se ha realizado correctamente, false en caso contrario.

Véase también canRemoveLast().

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

Sustituye el elemento index de la lista por object. Devuelve true si la operación se ha realizado correctamente, en caso contrario false.

Véase también canReplace().

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

Devuelve el número de elementos de la lista, o 0 si la operación falló.

Esta función se introdujo en Qt 6.2.

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

Compara este QQmlListReference con other, y devuelve true si son iguales. Los dos sólo se consideran iguales si uno se creó a partir del otro mediante asignación de copia o construcción de copia.