list QML Value Type
una lista de objetos QML. Más...
Descripción detallada
El tipo « list » hace referencia a una lista de objetos o valores QML.
Las propiedades de tipo « list » están vacías por defecto.
Un ` list ` puede almacenar objetos QML o valores de tipo numérico.
Al integrar con C++, ten en cuenta que cualquier valor de « QQmlListProperty » pasado a QML desde C++ se convierte automáticamente en un valor de « list », y viceversa.
Del mismo modo, cualquier ` QList<T> ` de un tipo de valor registrado ` T ` se convierte automáticamente en un valor ` list `, y viceversa.
Uso del tipo «list»
Por ejemplo, el tipo Item tiene una propiedad de tipo lista states a la que se puede asignar y utilizar de la siguiente manera:
import QtQuick
Item {
width: 100; height: 100
states: [
State { name: "activated" },
State { name: "deactivated" }
]
Component.onCompleted: {
console.log("Name of first state:", states[0].name)
for (var i = 0; i < states.length; i++)
console.log("state", i, states[i].name)
}
}Los objetos State definidos se añadirán a la lista states en el orden en que se definen.
Si la lista solo contiene un objeto, se pueden omitir los corchetes:
También puedes declarar tus propias propiedades de lista en QML:
import QtQml
QtObject {
property list<int> intList: [1, 2, 3, 4]
property list<QtObject> objectList
}Las listas se pueden utilizar de forma muy similar a los arrays de JavaScript. Por ejemplo:
- Los valores se asignan utilizando la sintaxis de corchetes de
[]con valores separados por comas - La propiedad `
length` proporciona el número de elementos de la lista - Se accede a los valores de la lista utilizando la sintaxis «
[index]» - Puedes utilizar `
push()` para añadir entradas - Se puede establecer la propiedad `
length` de la lista para truncarla o ampliarla.
Sin embargo, no se puede ampliar automáticamente la lista asignando un valor a un índice que se encuentre actualmente fuera de rango. Además, si se insertan valores de tipo « null » en una lista de objetos, estos se convierten en entradas de tipo « nullptr » en el objeto subyacente « QQmlListProperty ».
Una lista de tipos de valor se diferencia de un array de JavaScript en otro aspecto importante: al ampliarla estableciendo su longitud no se producen entradas indefinidas, sino instancias del tipo de valor construidas por defecto.
Del mismo modo, ampliar una lista de tipos de objeto de esta forma genera entradas «null», en lugar de entradas «undefined».
Este tipo de valor lo proporciona el lenguaje QML.
Véase también Tipos de valor de QML.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.