Qt Quick Widgets
El módulo Widgets de Qt Quick es un práctico envoltorio para QQuickWindow. Cargará y mostrará automáticamente una escena QML cuando se le proporcione la URL del archivo principal qml. Alternativamente, puede instanciar objetos QML utilizando QQmlComponent y colocarlos en un QQuickWidget configurado manualmente.
Uso típico:
QQuickWidget *view = new QQuickWidget; view->setSource(QUrl::fromLocalFile("myqmlfile.qml")); view->show();
QQuickWidget también gestiona el redimensionamiento de la vista y del elemento raíz. Por defecto, resizeMode está configurado como SizeViewToRootObject, que cargará el componente y cambiará su tamaño para ajustarlo a la vista. Alternativamente, puede configurar resizeMode a SizeViewToRootObject, que redimensionará la vista al elemento raíz.
Uso del módulo
Utilizar la API C++ de un módulo Qt requiere 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.
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 QuickWidgets)
target_link_libraries(mytarget PRIVATE Qt6::QuickWidgets)Para obtener más información, consulta la descripción general de la compilación con CMake.
Compilación con qmake quickwidgets
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 += quickwidgets
Referencia
Ejemplos
- Qt Quick Ejemplo de Widgets
- Ejemplo de comparación QQuickWidget - QQuickView
- Ejemplo de Previsualizador QML
Licencias y atribuciones
Qt Quick Widget 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.
© 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.