Exemple de comparaison entre QQuickWidget et QQuickView

Cet exemple permet d'afficher la même scène Qt Quick au sein d'une même interface utilisateur basée sur QWidget, en utilisant deux approches différentes :

• Utilisation d'un QQuickView.

  Elle est utilisée comme fenêtre enfant et avec la méthode QWidget::createWindowContainer()

• Utilisation de ` QQuickWidget`.

  Fonctionne comme un véritable QWidget et prend en charge, entre autres, un meilleur découpage et empilement, comme on peut l’attendre d’un véritable QWidget.

Cliquer sur la case à cocher « Show widget overlay » permet de voir un cas d’empilement de widgets qui ne s’affiche pas comme prévu lors de l’intégration d’une fenêtre native, tandis que « QQuickWidget » permet de l’afficher correctement.

Exécution de l’exemple

Vous pouvez exécuter l’exemple à partir de :

• Qt Creator

  Ouvrez le mode « Welcome » et sélectionnez l’exemple dans « Examples ». Pour plus d’informations, consultez Qt Creator: Tutoriel : Compiler et exécuter.

• Qt Extension for Visual Studio Code

  Exécutez la commande « Qt: Open Qt examples » à partir de Command Palette, puis sélectionnez l’exemple dans la liste. Pour plus d’informations, consultez Qt Extension for Visual Studio Code: Tutoriel : Compiler et exécuter.

Remarques sur la plate-forme

La scène Qt Quick utilise le 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, cet exemple est lié à OpenGL et ne fonctionnera pas avec d’autres API graphiques telles que Vulkan, Metal ou Direct3D.

Antialiasing multi-échantillonnage

Vous pouvez activer l’anticrénelage multi-échantillonnage en cochant la case correspondante. Lorsqu’il est activé, QQuickWidget effectue le rendu du contenu dans un tampon de rendu multi-échantillonnage. Après chaque passe de rendu, le contenu est converti en une texture 2D standard. Cela permet d’appliquer l’anticrénelage au contenu d’ Qt Quick sans affecter le reste de l’interface utilisateur basée sur QWidget.

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

Saisie au clavier

La scène Qt Quick prend en charge l’interaction 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 sur code.qt.io