En esta página

QQuickWidget - QQuickView Ejemplo de Comparación

Demuestra los beneficios de QQuickWidget sobre un QQuickView incrustado como ventana nativa.

Logotipo de Qt con superposición roja que muestra el apilamiento de widgets

El ejemplo permite mostrar la misma escena Qt Quick dentro de la misma interfaz de usuario basada en QWidget utilizando dos enfoques diferentes:

Haciendo clic en la casilla Show widget overlay se muestra un caso de apilamiento de widgets que no se renderiza como se espera al incrustar una ventana nativa, mientras que QQuickWidget hace que se renderice como se espera.

Ejecución del ejemplo

Para ejecutar el ejemplo desde Qt Creatorabra el modo Welcome y seleccione el ejemplo de Examples. Para más información, consulte Qt Creator: Tutorial: Construir y ejecutar.

Notas sobre la plataforma

La escena Qt Quick utiliza renderizado OpenGL directo, incluso cuando se incrusta con QQuickWidget. Esto confirma que el renderizado sigue utilizando la API 3D acelerada.

Por lo tanto, el ejemplo está ligado a OpenGL y no funcionará con otras APIs gráficas como Vulkan, Metal o Direct3D.

Antialiasing multimuestra

Puedes activar el antialiasing multimuestra seleccionando la casilla correspondiente. Cuando se activa, QQuickWidget renderiza el contenido en un búfer de renderizado multimuestra. Después de 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 multimuestreo para su superficie. Esto proporciona resultados similares, dependiendo del soporte de la plataforma.

Entrada de teclado

La escena Qt Quick admite la interacción del usuario, incluida la introducción de texto, independientemente de la tecnología de incrustación utilizada. Cuando se utiliza QQuickWidget, los eventos de entrada se reenvían automáticamente a la escena Qt Quick.

Proyecto de ejemplo @ code.qt.io

Véase también Qt Quick Widgets.

© 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.