En esta página

Qt Qml Soporte de diseño

El módulo de soporte de diseño de Qt Qml proporciona soporte para herramientas de diseño mediante un conjunto de tipos para registrar y hacer referencia a objetos en QML. Los objetos se identifican con una cadena clave en el momento del registro y los tipos de referencia pueden utilizar estas claves para obtener referencias a los objetos registrados. La idea es permitir una separación clara entre el código de la interfaz de usuario y la lógica de negocio, especialmente en los casos en los que el código de la interfaz de usuario se genera automáticamente con alguna herramienta y no se espera que los desarrolladores lo modifiquen manualmente. El módulo de soporte de diseño « Qt Qml » proporciona tanto una API de QML como una API de C++ para hacer referencia a los objetos registrados. El registro de objetos solo está disponible como API de QML.

El módulo de soporte de diseño « Qt Qml » se introdujo en Qt 6.12.

Uso del módulo

API de QML

Los tipos QML del módulo están disponibles a través de la importación ` QtQml.DesignSupport `. Para utilizar los tipos, añade la siguiente instrucción de importación a tu archivo .qml:

import QtQml.DesignSupport

La API de QML del módulo « Qt Qml Design Support» proporciona los tipos necesarios para registrar objetos QML y hacer referencia a los objetos QML registrados.

API de C++

Para utilizar la API de C++ de un módulo de Qt es necesario vincularla con la biblioteca del módulo, ya sea directamente o a través de otras dependencias. Varias herramientas de compilación cuentan con soporte específico para ello, entre ellas CMake y qmake.

La API de C++ del módulo « Qt Qml Design Support» proporciona las clases necesarias para hacer referencia a objetos QML registrados.

Compilación con CMake

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

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

Para obtener más detalles, consulta la descripción general de «Compilación con CMake ».

Compilación con qmake

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

QT += qmldesignsupport

Referencia de la API

Licencias y atribuciones

Qt Qml Design Support está disponible bajo licencias comerciales de The Qt Company. Además, está disponible bajo la Licencia Pública General Reducida de GNU, versión 3, o la Licencia Pública General de GNU, versión 2. Consulte Licencias de Qt 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.