En esta página

Ejemplo de comparación entre QQuickWidget y QQuickView

Muestra las ventajas de QQuickWidget frente a QQuickView integrado como una ventana nativa.

Logotipo de Qt con una capa roja que muestra el apilamiento de widgets

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

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:

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.

Proyecto de ejemplo en code.qt.io

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.