QQuickWidget - QQuickView Vergleichsbeispiel
Demonstriert die Vorteile von QQuickWidget gegenüber einem QQuickView eingebettet als natives Fenster.
Das Beispiel ermöglicht es, die gleiche Qt Quick Szene innerhalb der gleichen QWidget-basierten Benutzeroberfläche mit zwei verschiedenen Ansätzen zu zeigen:
- Verwendung eines QQuickView.
Es wird als Kindfenster und mit QWidget::createWindowContainer() verwendet.
- Verwendung von QQuickWidget.
Verhält sich wie ein echtes QWidget und unterstützt u.a. besseres Clipping und Stacking, wie es von einem echten QWidget erwartet wird.
Ein Klick auf das Kontrollkästchen Show widget overlay demonstriert einen Fall von 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
Zum Ausführen des Beispiels von Qt Creatorauszuführen, öffnen Sie den Modus Welcome und wählen Sie das Beispiel aus Examples aus. Weitere Informationen finden Sie unter Qt Creator: Tutorial: Erstellen und Ausführen.
Hinweise zur Plattform
Die Szene Qt Quick verwendet direktes OpenGL-Rendering, auch wenn sie in QQuickWidget eingebettet ist. Dies bestätigt, dass das Rendering weiterhin die beschleunigte 3D-API verwendet.
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 Funktion aktiviert ist, rendert QQuickWidget den Inhalt in einen Multisample-Renderbuffer. Nach jedem Renderdurchgang wird der Inhalt in eine Standard-2D-Textur aufgelöst. Dies ermöglicht Antialiasing für Qt Quick -Inhalte, ohne den Rest der QWidget-basierten Benutzeroberfläche zu beeinträchtigen.
Wenn Sie QQuickView verwenden, fordert das native Fenster Multisampling für seine Oberfläche an. Je nach Plattformunterstützung führt dies zu ähnlichen Ergebnissen.
Tastatureingabe
Die Szene Qt Quick unterstützt Benutzerinteraktion, einschließlich Texteingabe, unabhängig von der verwendeten Einbettungstechnologie. Bei Verwendung von QQuickWidget werden Eingabeereignisse automatisch an die Szene Qt Quick 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.
