QQuickWidget – QQuickView-Vergleichsbeispiel
Veranschaulicht die Vorteile von „ QQuickWidget “ gegenüber einem als natives Fenster eingebetteten „ QQuickView “.

Das Beispiel ermöglicht es, dieselbe „ Qt Quick “-Szene innerhalb derselben auf „ QWidget “ basierenden Benutzeroberfläche mit zwei unterschiedlichen Ansätzen darzustellen:
- Verwendung eines „ QQuickView “.
Es wird als untergeordnetes Fenster und mit ` QWidget::createWindowContainer()` verwendet.
- Verwendung von ` QQuickWidget`.
Funktioniert wie ein echtes „ QWidget “ und unterstützt unter anderem besseres Clipping und Stapeln, wie es von einem echten „ QWidget “ erwartet wird.
Ein Klick auf das Kontrollkästchen „ Show widget overlay “ veranschaulicht einen Fall der Widget-Stapelung, der beim Einbetten eines nativen Fensters nicht wie erwartet gerendert wird, während „ QQuickWidget “ dafür sorgt, dass es wie erwartet gerendert wird.
Ausführen des Beispiels
Sie können das Beispiel wie folgt ausführen:
- Qt Creator
Öffnen Sie den Modus „ Welcome “ und wählen Sie das Beispiel unter „ Examples “ aus. Weitere Informationen finden Sie unter Qt Creator: Tutorial: Erstellen und Ausführen.
- Qt Extension for Visual Studio Code
Führen Sie den Befehl „ Qt: Open Qt examples “ über „ Command Palette “ aus und wählen Sie das Beispiel aus der Liste aus. Weitere Informationen finden Sie unter Qt Extension for Visual Studio Code: Tutorial: Erstellen und Ausführen.
Hinweise zur Plattform
Die Szene „ Qt Quick “ nutzt direktes OpenGL-Rendering, selbst wenn sie in „ QQuickWidget “ eingebettet ist. Dies bestätigt, dass für das Rendering weiterhin die beschleunigte 3D-API verwendet wird.
Daher ist das Beispiel an OpenGL gebunden und funktioniert nicht mit anderen Grafik-APIs wie Vulkan, Metal oder Direct3D.
Multisample-Antialiasing
Sie können Multisample-Antialiasing aktivieren, indem Sie das entsprechende Kontrollkästchen aktivieren. Wenn diese Option aktiviert ist, rendert „ QQuickWidget “ Inhalte in einen Multisample-Renderbuffer. Nach jedem Renderdurchlauf wird der Inhalt in eine Standard-2D-Textur umgewandelt. Dadurch wird Antialiasing für „ Qt Quick “-Inhalte aktiviert, ohne den Rest der auf „ QWidget “ basierenden Benutzeroberfläche zu beeinträchtigen.
Wenn Sie „ QQuickView “ verwenden, fordert das native Fenster Multisampling für seine Oberfläche an. Dies liefert je nach Plattformunterstützung ähnliche Ergebnisse.
Tastatureingabe
Die „ Qt Quick “-Szene unterstützt Benutzerinteraktionen, einschließlich Texteingabe, unabhängig von der verwendeten Einbettungstechnologie. Bei Verwendung von „ QQuickWidget “ werden Eingabeereignisse automatisch an die „ Qt Quick “-Szene weitergeleitet.
Siehe auch „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.