Clases importantes de C++ que ofrece el módulo « Qt Qml »
El Qt Qml módulo proporciona clases de C++ que implementan el marco de trabajo QML. Los clientes pueden utilizar estas clases para interactuar con el tiempo de ejecución de QML (por ejemplo, inyectando datos o invocando métodos en objetos) y para instanciar una jerarquía de objetos a partir de un documento QML. El módulo Qt Qml proporciona más API de C++ además de las clases que se enumeran aquí; sin embargo, las clases aquí enumeradas constituyen los fundamentos del QML Runtime y los conceptos básicos de QML.
QML Runtime
Una aplicación QML típica con un punto de entrada en C++ instanciará un ` QQmlEngine ` y, a continuación, utilizará un ` QQmlComponent ` para cargar un documento QML. El motor proporciona un ` QQmlContext ` por defecto, que será el contexto de evaluación de nivel superior utilizado para evaluar las funciones y expresiones definidas en el documento QML. La jerarquía de objetos definida en el documento QML se instanciará llamando a la función ` create()` de la instancia ` QQmlComponent `, siempre que no se hayan producido errores durante la carga del documento.
Es posible que el cliente desee modificar el ` QQmlContext ` proporcionado por el motor, inyectando propiedades u objetos en el contexto. Para ello, puede llamar a la función ` QQmlEngine::rootContext()` para acceder al contexto de nivel superior.
Tras instanciar el objeto, el cliente suele pasar el control al bucle de eventos de la aplicación, de modo que los eventos de entrada del usuario (como los clics del ratón) puedan ser transmitidos y gestionados por la aplicación.
Nota: El módulo « Qt Quick » proporciona una clase de conveniencia, « QQuickView », que ofrece un QML Runtime y una ventana visual para mostrar una aplicación QML.
La clase QQmlEngine
La clase ` QQmlEngine ` proporciona un motor capaz de gestionar una jerarquía de objetos definida en un documento QML. Proporciona un contexto QML raíz en el que se evalúan las expresiones y garantiza que las propiedades de los objetos se actualicen correctamente cuando sea necesario.
Un ` QQmlEngine ` permite configurar ajustes globales que se aplican a todos los objetos que gestiona; por ejemplo, el ` QNetworkAccessManager ` que se utilizará para las comunicaciones de red y la ruta de archivo que se utilizará para el almacenamiento persistente.
Consulte la documentación de la clase « QQmlEngine » para obtener información detallada sobre lo que ofrece la clase « QQmlEngine » y cómo se puede utilizar en una aplicación.
La clase `QQmlContext`
La clase ` QQmlContext ` proporciona un contexto para la instanciación de objetos y la evaluación de expresiones. Todos los objetos se instancian en un contexto concreto, y todas las expresiones que se evalúan mientras se ejecuta una aplicación se evalúan dentro de un contexto concreto. Este contexto define cómo se resuelven los símbolos y, por lo tanto, sobre qué valores opera la expresión.
Consulte la documentación de la clase ` QQmlContext ` para obtener información detallada sobre cómo modificar el contexto de evaluación de un objeto añadiendo o eliminando propiedades de un ` QQmlContext`, y cómo acceder al contexto de un objeto.
Instanciación dinámica de objetos y evaluación de expresiones
La instanciación dinámica de objetos y la evaluación dinámica de expresiones son conceptos fundamentales en QML. Los documentos QML definen tipos de objetos que pueden instanciarse en tiempo de ejecución utilizando un ` QQmlComponent`. Una instancia de la clase ` QQmlComponent ` puede crearse directamente en C++ o mediante la función ` Qt.createComponent()` en código QML imperativo. Se pueden calcular expresiones arbitrarias en C++ mediante la clase QQmlExpression, y dichas expresiones pueden interactuar directamente con el contexto de QML.
La clase QQmlComponent
La clase ` QQmlComponent ` se puede utilizar para cargar un documento QML. Requiere un ` QQmlEngine ` para instanciar la jerarquía de objetos definida en el documento QML.
Consulta la documentación de la clase ` QQmlComponent ` para obtener información detallada sobre cómo utilizar ` QQmlComponent`.
La clase `QQmlExpression`
La clase ` QQmlExpression ` ofrece a los clientes una forma de evaluar expresiones JavaScript desde C++, utilizando un contexto de evaluación QML específico. Esto permite a los clientes acceder a objetos QML por su identificador, por ejemplo. El resultado de la evaluación se devuelve como un ` QVariant`, y las reglas de conversión las define el motor QML.
Consulte la documentación de la clase ` QQmlExpression ` para obtener información detallada sobre cómo utilizar ` QQmlExpression ` en una aplicación.
Uso de las clases en aplicaciones QML
Estas páginas describen cómo crear aplicaciones QML que interactúen con las clases de C++:
© 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.