Sur cette page

Exemple de comparaison QQuickWidget - QQuickView

Démontre les avantages de QQuickWidget par rapport à QQuickView intégré en tant que fenêtre native.

Logo Qt avec recouvrement rouge démontrant l'empilement des widgets

L'exemple permet de montrer la même scène Qt Quick dans la même interface utilisateur basée sur QWidget en utilisant deux approches différentes :

Un clic sur la case à cocher Show widget overlay montre un cas d'empilement de widgets dont le rendu n'est pas conforme aux attentes lors de l'intégration d'une fenêtre native, alors que QQuickWidget permet un rendu conforme aux attentes.

Exécution de l'exemple

Pour exécuter l'exemple à partir de Qt Creatorouvrez le mode Welcome et sélectionnez l'exemple à partir de Examples. Pour plus d'informations, voir Qt Creator: Tutoriel : Construire et exécuter.

Notes sur la plate-forme

La scène Qt Quick utilise un rendu OpenGL direct, même lorsqu'elle est intégrée à QQuickWidget. Cela confirme que le rendu continue d'utiliser l'API 3D accélérée.

Par conséquent, l'exemple est lié à OpenGL et ne fonctionnera pas avec d'autres API graphiques telles que Vulkan, Metal ou Direct3D.

Anti-crénelage multi-échantillon

Vous pouvez activer l'anticrénelage multi-échantillon en cochant la case correspondante. Lorsque cette option est activée, QQuickWidget effectue le rendu du contenu dans un tampon de rendu multi-échantillon. Après chaque passage de rendu, le contenu est transformé en une texture 2D standard. Cela permet l'anticrénelage du contenu Qt Quick sans affecter le reste de l'interface utilisateur basée sur QWidget.

Si vous utilisez QQuickView, la fenêtre native demande un multi-échantillonnage pour sa surface. Cela donne des résultats similaires, en fonction de la prise en charge de la plateforme.

Saisie au clavier

La scène Qt Quick prend en charge l'interaction avec l'utilisateur, y compris la saisie de texte, quelle que soit la technologie d'intégration utilisée. Lorsque vous utilisez QQuickWidget, les événements de saisie sont automatiquement transmis à la scène Qt Quick.

Exemple de projet @ code.qt.io

Voir aussi 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.