Tipos de secuencia en QML
Para cada tipo de objeto y tipo de valor, se pone automáticamente a disposición un tipo de secuencia que permite almacenar varias instancias de dicho tipo. Puedes utilizar la palabra clave « list » para crear propiedades de tipos de secuencia:
import QtQml
QtObject {
property list<int> ints: [1, 2, 3, 4]
property list<Connection> connections: [
Connection {
// ...
},
Connection {
// ...
}
]
}Las secuencias de tipos de valor se implementan como « QList » y las de tipos de objeto, como « QQmlListProperty ».
Las secuencias en QML se comportan, en general, como el tipo ` Array ` de JavaScript, con algunas diferencias importantes derivadas del uso de un tipo de almacenamiento de C++ en la implementación:
- Al eliminar un elemento de una secuencia, dicho elemento se sustituirá por un valor construido por defecto, en lugar de por un valor de tipo `
undefined`. - Si se establece la propiedad `
length` de una secuencia en un valor mayor que su valor actual, la secuencia se rellenará hasta la longitud especificada con elementos construidos por defecto, en lugar de elementos `undefined`. - Las clases de contenedores de Qt admiten índices enteros con signo (en lugar de sin signo); por lo tanto, cualquier intento de acceder a un índice mayor que el número máximo que puede contener ` qsizetype ` fallará.
Si deseas eliminar elementos de una secuencia en lugar de simplemente sustituirlos por valores construidos por defecto, no utilices el operador de eliminación indexada (delete sequence[i]), sino la función splice (sequence.splice(startIndex, deleteCount)).
En general, cualquier contenedor reconocible por QMetaSequence puede pasarse de C++ a QML mediante los métodos Q_PROPERTY o Q_INVOKABLE. Esto incluye, entre otros, todos los QList, QQueue, QStack, QSet, std::list y std::vector registrados que contengan un tipo marcado con Q_DECLARE_METATYPE.
El uso de una secuencia a través de QMetaSequence conlleva costosas conversiones de datos. Para evitar estas conversiones, puedes registrar tus propios tipos de secuencia anónimos utilizando QML_SEQUENTIAL_CONTAINER desde C++. Los tipos registrados de esta manera se comportan como los tipos de secuencia predefinidos y se almacenan tal cual. Sin embargo, no tienen nombres QML.
Advertencia: Las secuencias almacenadas como contenedores de C++, como QList o std::vector, están sujetas a los efectos provocados por los tipos de valor y las referencias a secuencias de QML, por lo que deben manejarse con cuidado. QQmlListProperty no se ve afectado, ya que solo es una vista de un contenedor subyacente. Los contenedores estándar de C++, como std::vector, no se comparten de forma implícita. Por lo tanto, al copiarlos siempre se produce una copia profunda. Dado que una secuencia leída desde una propiedad siempre tiene que copiarse al menos una vez, el uso de dichos contenedores como secuencias QML resulta bastante costoso, incluso si no se modifican desde QML.
El módulo « QtQml » contiene algunas « sequence types » que quizá te interese utilizar.
© 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.