Qt Qml

El módulo Qt Qml proporciona un marco para desarrollar aplicaciones y bibliotecas con el lenguaje QML. Define e implementa la infraestructura del lenguaje y del motor, y proporciona una API que permite a los desarrolladores de aplicaciones registrar tipos y módulos QML personalizados e integrar código QML con JavaScript y C++. El módulo Qt Qml proporciona un QML API y un C++ API.

Uso del módulo

API QML

Los tipos QML del módulo están disponibles a través de la importación QtQml. Para utilizar los tipos, añada la siguiente sentencia import a su archivo .qml:

import QtQml

El módulo Qt Qml contiene el marco QML e importantes tipos QML utilizados en las aplicaciones. Las construcciones de QML se describen en The QML Reference.

La dirección QML API del módulo Qt Qml proporciona una serie de tipos de objeto QML, tipos de valor QML y espacios de nombres.

API C

Para utilizar la API C++ de un módulo Qt es necesario enlazar con la biblioteca del módulo, ya sea directamente o a través de otras dependencias. Varias herramientas de compilación tienen soporte dedicado para esto, incluyendo CMake y qmake.

La API de C++ contiene algunas clases importantes con las que deberías familiarizarte. También proporciona tipos para contener valores JavaScript.

Construcción con CMake

Utilice el comando find_package() para localizar el componente del módulo necesario en el paquete Qt6:

find_package(Qt6 REQUIRED COMPONENTS Qml)
target_link_libraries(mytarget PRIVATE Qt6::Qml)

Para obtener más información, consulte la descripción general de la compilación con CMake.

Para proporcionar compatibilidad con tipos QML ajenos a una biblioteca que no sea QML, localice el módulo QmlIntegration como se indica a continuación:

find_package(Qt6 REQUIRED COMPONENTS QmlIntegration)
target_link_libraries(mytarget PRIVATE Qt6::QmlIntegration)

Consulte qt6_generate_foreign_qml_types para obtener más detalles.

Compilación con qmake

Para configurar el módulo para su compilación con qmake, añada el módulo como valor de la variable QT en el archivo .pro del proyecto:

QT += qml

Registro de tipos QML y módulos QML

Para registrar tipos para su uso con QML, primero debe definir un módulo QML, preferiblemente utilizando qt_add_qml_module en CMake. A continuación, puede añadir cabeceras C++ a su nuevo módulo y definir en ellas los tipos que se expondrán a QML.

Ajustar el motor

Hay una serie de botones que puede girar para personalizar el comportamiento del motor QML. La página sobre la configuración del motor JavaScript enumera las variables de entorno que puede utilizar a tal efecto. La descripción de la caché de disco QML describe las opciones relacionadas con el modo en que se compilan y cargan los componentes QML.

Artículos y guías

Estos artículos contienen información sobre Qt Qml.

• La referencia QML
• Qt Qml Herramientas
• Escritura de módulos QML
• Singletons en QML

Referencia

• C++ Classes
• QML Types

Licencias y atribuciones

Qt Qml está disponible bajo licencias comerciales de The Qt Company. Además, está disponible bajo licencias de software libre. Desde Qt 5.4, estas licencias de software libre son GNU Lesser General Public License, versión 3, o la GNU General Public License, versión 2. Ver Licencias de Qt para más detalles.

Además Qt Qml en Qt 6.11.0 puede contener módulos de terceros bajo las siguientes licencias permisivas: