Tipos de valor de QML
QML admite tipos de valor integrados y personalizados.
Un tipo de valor es aquel que, conceptualmente, se pasa por valor en lugar de por referencia, como, por ejemplo, un ` int ` o un ` string`. Esto contrasta con los tipos de objeto de QML. Los tipos de objeto se pasan por referencia. Si asignas una instancia de un tipo de objeto a dos propiedades diferentes, ambas propiedades contienen el mismo valor. Cualquier modificación del objeto se refleja en ambas propiedades. Si asignas una instancia de un tipo de valor a dos propiedades diferentes, las propiedades contienen valores distintos. Si modificas una de ellas, la otra permanece igual. Los tipos de valor solo se pasan por valor de forma conceptual, ya que debe seguir siendo posible interactuar con ellos como si fueran objetos de JavaScript. Para facilitar esto, en realidad se pasan como referencias de tipo de valor cuando se accede a ellos desde código JavaScript.
A diferencia de un tipo de objeto, un tipo de valor no se puede utilizar para declarar objetos QML: no es posible, por ejemplo, declarar un objeto ` int{} ` o un objeto ` size{} `.
Los tipos de valor se pueden utilizar para hacer referencia a:
- Un valor único (p. ej., int hace referencia a un único número)
- Un valor que contenga propiedades y métodos (p. ej., size hace referencia a un valor con las propiedades
widthyheight) - El tipo genérico var. Puede contener valores de cualquier otro tipo, pero es en sí mismo un tipo de valor.
Cuando una variable o propiedad contiene un tipo de valor y se asigna a otra variable o propiedad, se realiza una copia del valor.
Tipos de valor disponibles
Algunos tipos de valor son compatibles con el motor de forma predeterminada y no requieren una instrucción de importación para su uso, mientras que otros sí requieren que el cliente importe el módulo que los proporciona. Todos los tipos de valor enumerados a continuación pueden utilizarse como tipo ` property ` en un documento QML, con las siguientes excepciones:
void, que indica la ausencia de un valorlistdebe utilizarse junto con un objeto o un tipo de valor como elemento
Tipos de valor integrados proporcionados por el lenguaje QML
A continuación se enumeran los tipos de valor integrados que el lenguaje QML admite de forma nativa:
Valor binario verdadero/falso | |
Valor de fecha | |
Número con punto decimal, almacenado en precisión doble | |
Número entero, p. ej., 0, 10 o -20 | |
Lista de objetos QML | |
Número con punto decimal | |
Cadena de texto de formato libre | |
Localizador de recursos | |
Tipo de propiedad genérico | |
Tipo de propiedad genérico | |
Tipo de valor vacío |
Tipos de valor proporcionados por los módulos QML
Los módulos QML pueden ampliar el lenguaje QML con más tipos de valor.
Por ejemplo, los tipos de valor proporcionados por el módulo « QtQml » son:
Valor que representa una curva de aceleración | |
Valor con atributos x e y | |
Valor que hace referencia a una propiedad de un objeto | |
Valor con atributos x, y, width y height | |
Valor con los atributos «width» y «height» |
Los tipos de valor que ofrece el módulo « QtQuick » son:
Un valor de color ARGB | |
Valor de fuente con las propiedades de QFont. El tipo de fuente hace referencia a un valor de fuente con las propiedades de QFont | |
Un tipo «matrix4x4» es una matriz de 4 filas y 4 columnas | |
Un tipo «cuaternión» tiene los atributos escalar, x, y y z | |
Un tipo vector2d tiene los atributos x e y | |
Valor con atributos x, y y z | |
Un tipo vector4d tiene los atributos x, y, z y w |
El objeto global ` Qt ` proporciona ` useful functions ` para manipular valores de tipos de valor para el Qt Qml y Qt Quick .
Otros módulos de Qt documentarán sus tipos de valor en las páginas correspondientes a cada módulo.
Puedes definir tus propios tipos de valor tal y como se describe en Definición de tipos QML desde C++. Para poder utilizar los tipos proporcionados por un módulo QML concreto, los clientes deben importar dicho módulo en sus documentos QML.
Comportamiento de los cambios de propiedad para los tipos de valor
Algunos tipos de valor tienen propiedades: por ejemplo, el tipo ` font ` tiene las propiedades ` pixelSize`, ` family ` y ` bold `. A diferencia de las propiedades de los tipos de objeto, las propiedades de los tipos de valor no proporcionan sus propias señales de cambio de propiedad. Solo es posible crear un controlador de señal de cambio de propiedad para la propia propiedad del tipo de valor:
Text {
// invalid!
onFont.pixelSizeChanged: doSomething()
// also invalid!
font {
onPixelSizeChanged: doSomething()
}
// but this is ok
onFontChanged: doSomething()
}Sin embargo, hay que tener en cuenta que se emite una señal de cambio de propiedad para un tipo de valor cada vez que cambia cualquiera de sus atributos, así como cuando cambia la propia propiedad. Tomemos como ejemplo el siguiente código:
Text {
onFontChanged: console.log("font changed")
Text { id: otherText }
focus: true
// changing any of the font attributes, or reassigning the property
// to a different font value, will invoke the onFontChanged handler
Keys.onDigit1Pressed: font.pixelSize += 1
Keys.onDigit2Pressed: font.b = !font.b
Keys.onDigit3Pressed: font = otherText.font
}Por el contrario, las propiedades de un tipo de objeto emiten sus propias señales de cambio de propiedad, y un controlador de señales de cambio de propiedad para una propiedad de tipo objeto solo se invoca cuando la propiedad se reasigna a un valor de objeto diferente.
Véase también El sistema de tipos 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.