Referencias a tipos de valor y secuencias en QML
Los tipos de valor y los tipos de secuencia de QML se pasan necesariamente por valor. A diferencia de los tipos de objeto de QML, no tienen identidad propia, sino que solo se puede acceder a ellos como propiedades de otros objetos o valores, o como valores devueltos por métodos. Cada uno de estos accesos crea implícitamente una copia. Sin embargo, en JavaScript todo es un objeto. En JavaScript no existe el concepto de «tipo de valor». Por ejemplo, si ejecutas font.bold = true en JavaScript, esperamos que se establezca la propiedad bold de font, independientemente de cuál sea el valor de font. Pero considera el siguiente fragmento de código:
import QtQuick
Text {
onSomethingHappened: font.bold = true
}En este caso sabemos que font es un tipo de valor. Al acceder a él se crea una copia local mediante la llamada al getter de Q_PROPERTY. A continuación, podemos establecer la propiedad bold en ella, pero eso normalmente solo afectaría a la copia, no al Q_PROPERTY original.
Para solucionar este problema, QML ofrece el concepto de referencias. Cuando se recupera una instancia de un tipo de valor o secuencia desde una propiedad, el motor de QML recuerda la propiedad junto con el propio valor. Si se modifica el valor, se vuelve a escribir en la propiedad. Esto produce la ilusión de un objeto con identidad independiente y hace que el caso anterior, junto con muchos otros, funcione sin problemas.
Sin embargo, esto puede resultar bastante costoso. Si una secuencia se expone como un ` Q_PROPERTY`, acceder a cualquier valor de la secuencia mediante un índice provocará que se lean todos los datos de la secuencia desde la propiedad. A partir de estos datos de la secuencia, se recupera entonces un único elemento. Del mismo modo, modificar cualquier valor de la secuencia provoca que se lean los datos de la secuencia. A continuación, se lleva a cabo la modificación y la secuencia modificada se vuelve a escribir en la propiedad. Una operación de lectura puede resultar relativamente económica si el tipo en cuestión se comparte implícitamente. Una modificación siempre conlleva al menos una copia profunda.
Si devuelves una instancia de una secuencia o un tipo de valor desde una función ` Q_INVOKABLE `, evitas esa sobrecarga. Los valores devueltos no están vinculados a ninguna propiedad y no se volverán a escribir.
Las secuencias de tipos de objeto se pasan como « QQmlListProperty » por defecto. « QQmlListProperty » no es un contenedor real, sino solo una vista, o referencia, a algún almacenamiento secuencial. Por lo tanto, « QQmlListProperty » no se ve afectado por este efecto. Sin embargo, puedes registrar otros tipos de secuencia para objetos utilizando « QML_SEQUENTIAL_CONTAINER ». Esos sí se verán afectados.
© 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.