Sur cette page

Qt Quick Widgets

Le module « Widgets » d'Qt Quick est une interface pratique pour QQuickWindow. Il charge et affiche automatiquement une scène QML lorsqu'on lui fournit l'URL du fichier principal qml. Vous pouvez également instancier des objets QML à l'aide de QQmlComponent et les placer dans un fichier QQuickWidget configuré manuellement.

Utilisation type :

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

QQuickWidget gère également le redimensionnement de la vue et de l’élément racine. Par défaut, la propriété ` resizeMode ` est définie sur ` SizeViewToRootObject`, ce qui charge le composant et le redimensionne pour l’adapter à la vue. Vous pouvez également définir ` resizeMode ` sur ` SizeViewToRootObject`, ce qui redimensionnera la vue en fonction de l’élément racine.

Utilisation du module

L'utilisation de l'API C++ d'un module Qt nécessite de lier le code à la bibliothèque du module, soit directement, soit via d'autres dépendances. Plusieurs outils de compilation prennent cela en charge, notamment CMake et qmake.

Compilation avec CMake

Utilisez la commande « find_package() » pour localiser le composant de module requis dans le paquet « Qt6 » :

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

Pour plus de détails, consultez la présentation « Compilation avec CMake ».

Compilation avec qmake quickwidgets

Pour configurer le module en vue d’une compilation avec qmake, ajoutez le module en tant que valeur de la variable ` QT ` dans le fichier .pro du projet :

QT += quickwidgets

Référence

Exemples

Licences et mentions

Qt Quick Le widget est disponible sous licence commerciale auprès de The Qt Company. Il est également disponible sous licence de logiciel libre. Depuis Qt 5.4, ces licences de logiciel libre sont la Licence publique générale restreinte GNU, version 3, ou la Licence publique générale GNU, version 2. Voir Licences Qt pour plus de détails.

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