El sistema de tipos de QML
Los tipos que pueden utilizarse en la definición de una jerarquía de objetos en un documento QML pueden proceder de diversas fuentes. Pueden ser:
- proporcionados de forma nativa por el lenguaje QML
- registrados mediante C++ por módulos de QML
- proporcionados como documentos QML por módulos QML
Además, los desarrolladores de aplicaciones pueden proporcionar sus propios tipos, ya sea registrando tipos de C++ directamente o definiendo componentes reutilizables en documentos QML que luego se pueden importar.
Independientemente del origen de las definiciones de tipos, el motor garantizará la seguridad de tipos para las propiedades y las instancias de dichos tipos.
Tipos de objetos QML
Un tipo de objeto QML es un tipo a partir del cual se puede instanciar un objeto QML. Los tipos de objeto QML se derivan de ` QtObject` y son proporcionados por módulos QML. Las aplicaciones pueden importar estos módulos para utilizar los tipos de objeto que proporcionan. El módulo ` QtQuick ` proporciona los tipos de objeto más comunes necesarios para crear interfaces de usuario en QML.
Por último, cada documento QML define implícitamente un tipo de objeto QML, que puede reutilizarse en otros documentos QML. Consulte la documentación sobre tipos de objeto en el sistema de tipos de QML para obtener información detallada sobre los tipos de objeto.
Tipos de valor de QML
El lenguaje QML cuenta con soporte integrado para diversos tipos primitivos, entre los que se incluyen enteros, números de coma flotante de doble precisión, cadenas de caracteres y valores booleanos. Los objetos pueden tener propiedades de estos tipos, y los valores de estos tipos pueden pasarse como argumentos a los métodos de los objetos.
Consulta la documentación sobre tipos de valor de QML para obtener más información al respecto.
Tipos de secuencia de QML
Los tipos de secuencia se pueden utilizar para almacenar secuencias de valores u objetos.
Consulta la documentación sobre los tipos de secuencia en el sistema de tipos de QML para obtener información detallada sobre los tipos de secuencia.
Enumeraciones
En QML, las enumeraciones se tratan como propiedades especiales de los tipos.
Consulta la documentación sobre enumeraciones de QML para obtener información detallada al respecto.
Tipos singleton
QML admite tipos singleton, que permiten definir un tipo del que solo existe una instancia en cada motor de QML. Los tipos singleton resultan útiles para proporcionar un estado o una funcionalidad a nivel de toda la aplicación.
Consulta «Singletons en QML » para obtener más detalles.
Tipos adjuntos
Las propiedades y los controladores de señales adjuntos permiten a los tipos proporcionar propiedades y señales adicionales que pueden adjuntarse a otros objetos. Se trata de un potente mecanismo para añadir información contextual a los objetos QML.
Consulta «Tipos adjuntos en QML» para obtener más detalles.
Espacios de nombres de QML
Los espacios de nombres de QML se pueden utilizar para exponer enumeraciones procedentes de espacios de nombres de C++.
Consulta la documentación sobre espacios de nombres en el sistema de tipos de QML para obtener información detallada al respecto.
Tipos de JavaScript
El motor de QML admite objetos y matrices de JavaScript. Se puede crear y almacenar cualquier tipo estándar de JavaScript utilizando el tipo genérico ` var `.
Por ejemplo, están disponibles los tipos estándar ` Date ` y ` Array `, tal y como se muestra a continuación:
import QtQuick
Item {
property var theArray: []
property var theDate: new Date()
Component.onCompleted: {
for (var i = 0; i < 10; i++)
theArray.push("Item " + i)
console.log("There are", theArray.length, "items in the array")
console.log("The time is", theDate.toUTCString())
}
}Consulte «Expresiones de JavaScript en documentos QML » para obtener más detalles.
Integración con C++
Conversión de tipos de datos entre QML y C++
Al integrar QML con C++, a menudo es necesario transferir datos entre ambos entornos. El motor de QML proporciona conversión automática entre los tipos de QML y C++ para los tipos de datos comunes, mientras que los tipos personalizados requieren un registro explícito.
Consulta «Conversión de tipos de datos entre QML y C++» para obtener más detalles.
Interacción con objetos QML desde C++
El código C++ puede acceder a objetos QML y manipularlos obteniendo referencias a ellos desde el motor de QML. Esto permite al código C++ leer y escribir propiedades, invocar métodos y conectarse a señales de objetos QML.
Consulta Interacción con objetos QML desde C++ para obtener más detalles.
Integración con valores de JavaScript desde C++
El motor de QML representa los valores de JavaScript mediante la clase ` QJSValue ` y otras clases relacionadas, lo que permite al código C++ trabajar con objetos, funciones y valores primitivos de JavaScript. Esto permite una integración perfecta entre el código C++ y el de JavaScript.
Consulta «Integración con valores de JavaScript desde C++» para obtener más detalles.
Incorporación de objetos C++ en QML con propiedades de contexto
Se debe evitar el uso de propiedades de contexto. Consulta «Incrustación de objetos C++ en QML mediante propiedades de contexto » para obtener más detalles.
© 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.