Qt Quick Widgets

Das Modul Qt Quick Widgets ist ein einfacher Wrapper für QQuickWindow. Es lädt und zeigt automatisch eine QML-Szene an, wenn die URL der Hauptdatei qml angegeben wird. Alternativ können Sie QML-Objekte mit QQmlComponent instanziieren und sie in einer manuell eingerichteten QQuickWidget platzieren.

Typische Verwendung:

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

QQuickWidget Das Programm verwaltet auch die Größenänderung der Ansicht und des Stammelements. Standardmäßig ist resizeMode auf SizeViewToRootObject eingestellt, wodurch die Komponente geladen und ihre Größe an die Ansicht angepasst wird. Alternativ dazu können Sie resizeMode auf SizeViewToRootObject setzen, wodurch die Größe der Ansicht an das Stammelement angepasst wird.

Verwendung des Moduls

Die Verwendung der C++-API eines Qt-Moduls erfordert eine 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.

Bauen 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 Einzelheiten finden Sie in der Übersicht Bauen mit CMake.

Bauen mit qmake quickwidgets

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

QT += quickwidgets

Referenz

Lizenzen und Namensnennung

Qt Quick Widget ist unter kommerziellen Lizenzen von The Qt Company erhältlich. Darüber hinaus ist es unter freien Software-Lizenzen verfügbar. Seit Qt 5.4 sind diese Lizenzen für freie Software die GNU Lesser General Public License, Version 3, oder die GNU General Public License, Version 2. Siehe Qt-Lizenzierung für weitere Details.

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