Auf dieser Seite

Qt Quick Widgets

Das Modul „ Qt Quick -Widgets“ ist ein praktischer Wrapper für QQuickWindow. Es lädt automatisch eine QML-Szene und zeigt sie an, sobald die URL der Hauptdatei „ qml “ angegeben wird. Alternativ können Sie QML-Objekte mithilfe von QQmlComponent instanziieren und in eine manuell eingerichtete Datei „ QQuickWidget “ einfügen.

Typische Verwendung:

QQuickWidget *view = new QQuickWidget;
view->setSource(QUrl::fromLocalFile("myqmlfile.qml"));
view->show();

QQuickWidget verwaltet auch die Größenanpassung der Ansicht und des Stammelements. Standardmäßig ist „ resizeMode “ auf „ SizeViewToRootObject “ gesetzt, wodurch die Komponente geladen und an die Größe der Ansicht angepasst wird. Alternativ können Sie „ resizeMode “ auf „ SizeViewToRootObject “ setzen, wodurch die Ansicht an die Größe des Stammelements angepasst wird.

Verwendung des Moduls

Die Verwendung der C++-API eines Qt-Moduls erfordert die Verknüpfung mit der Modulbibliothek, entweder direkt oder über andere Abhängigkeiten. Mehrere Build-Tools bieten hierfür spezielle Unterstützung, darunter CMake und qmake.

Erstellen mit CMake

Verwenden Sie den Befehl „ find_package() “, um die benötigte Modulkomponente im Paket „ Qt6 “ zu finden:

find_package(Qt6 REQUIRED COMPONENTS QuickWidgets)
target_link_libraries(mytarget PRIVATE Qt6::QuickWidgets)

Weitere Details finden Sie in der Übersicht „Erstellen mit CMake “.

Erstellen mit qmake quickwidgets

Um das Modul für die Erstellung mit qmake zu konfigurieren, fügen Sie das Modul als Wert der Variablen ` QT ` in der `.pro`-Datei des Projekts hinzu:

QT += quickwidgets

Referenz

Beispiele

Lizenzen und Urheberangaben

Qt Quick Das Widget ist unter kommerziellen Lizenzen von The Qt Company erhältlich. Darüber hinaus ist es unter freien Softwarelizenzen verfügbar. Seit Qt 5.4 sind diese freien Softwarelizenzen die GNU Lesser General Public License, Version 3, oder die GNU General Public License, Version 2. Weitere Informationen finden Sie unter Qt-Lizenzierung.

© 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.