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

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 :
- Utilisation d'une fenêtre QQuickView.
Elle est utilisée comme fenêtre enfant et avec QWidget::createWindowContainer()
- En utilisant QQuickWidget.
Agit comme une véritable QWidget et prend en charge, entre autres, un meilleur écrêtage et un meilleur empilage, comme on l'attend d'une véritable QWidget.
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.
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.