Ejemplo de comparación entre QQuickWidget y QQuickView
Muestra las ventajas de QQuickWidget frente a QQuickView integrado como una ventana nativa.

El ejemplo permite mostrar la misma escena de « Qt Quick » dentro de la misma interfaz de usuario basada en « QWidget » utilizando dos enfoques diferentes:
- Utilizando un QQuickView.
Se utiliza como ventana secundaria y con QWidget::createWindowContainer()
- Utilizando QQuickWidget.
Actúa como un auténtico QWidget y admite, entre otras cosas, un mejor recorte y apilamiento, tal y como cabe esperar de un auténtico QWidget.
Al marcar la casilla « Show widget overlay » se muestra un caso de apilamiento de widgets que no se representa como se esperaba al incrustar una ventana nativa, mientras que « QQuickWidget » hace que se represente correctamente.
Ejecución del ejemplo
Puede ejecutar el ejemplo desde:
- Qt Creator
Abre el modo « Welcome » y selecciona el ejemplo en « Examples ». Para obtener más información, consulta Qt Creator: Tutorial: Compilar y ejecutar.
- Qt Extension for Visual Studio Code
Ejecuta el comando « Qt: Open Qt examples » desde Command Palette y selecciona el ejemplo de la lista. Para obtener más información, consulta Qt Extension for Visual Studio Code: Tutorial: Compilar y ejecutar.
Notas sobre la plataforma
La escena « Qt Quick » utiliza renderizado directo de OpenGL, incluso cuando se integra con QQuickWidget. Esto confirma que el renderizado sigue utilizando la API 3D acelerada.
Por lo tanto, el ejemplo está vinculado a OpenGL y no funcionará con otras API gráficas como Vulkan, Metal o Direct3D.
Antialiasing multimuestra
Puedes habilitar el antialiasing multimuestra marcando la casilla correspondiente. Cuando está habilitado, QQuickWidget renderiza el contenido en un búfer de renderizado multimuestra. Tras cada pasada de renderizado, el contenido se resuelve en una textura 2D estándar. Esto habilita el antialiasing para el contenido de Qt Quick sin afectar al resto de la interfaz de usuario basada en QWidget.
Si utilizas « QQuickView », la ventana nativa solicita el multimuestreo para su superficie. Esto proporciona resultados similares, dependiendo de la compatibilidad de la plataforma.
Entrada por teclado
La escena Qt Quick admite la interacción del usuario, incluida la entrada de texto, independientemente de la tecnología de incrustación utilizada. Al utilizar QQuickWidget, los eventos de entrada se reenvían automáticamente a la escena Qt Quick.
Véase también Widgets deQt Quick .
© 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.