QQuickStyle Class
La classe QQuickStyle permet de configurer le style de l'application. En savoir plus...
| En-tête : | #include <QQuickStyle> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS QuickControls2) target_link_libraries(mytarget PRIVATE Qt6::QuickControls2) |
| qmake : | QT += quickcontrols2 |
Membres publics statiques
| QString | name() |
| void | setFallbackStyle(const QString &style) |
| void | setStyle(const QString &style) |
Description détaillée
QQuickStyle fournit une API permettant d'interroger et de configurer les styles d'application de Qt Quick Controls.
#include <QGuiApplication>
#include <QQmlApplicationEngine>
#include <QQuickStyle>
int main(int argc, char *argv[])
{
QGuiApplication app(argc, argv);
QQuickStyle::setStyle("Material");
QQmlApplicationEngine engine;
engine.load(QUrl("qrc:/main.qml"));
return app.exec();
}Remarque : le style doit être configuré avant de charger le fichier QML qui importe Qt Quick Controls. Il n'est pas possible de modifier le style une fois que les types QML ont été enregistrés.
Remarque : QQuickStyle n'est pas pris en charge lors de l'utilisation de la sélection de style à la compilation.
Pour créer votre propre style personnalisé, consultez la section Création d’un style personnalisé. Les styles personnalisés ne doivent pas nécessairement implémenter tous les contrôles. Par défaut, le système de stylisation utilise le style « Basic » comme style de secours pour les contrôles non pris en charge par un style personnalisé. Il est possible de spécifier un style de secours différent pour personnaliser ou étendre l’un des styles intégrés.
QQuickStyle::setStyle("MyStyle");
QQuickStyle::setFallbackStyle("Material");Voir également «Stylisation » Qt Quick Controls.
Documentation sur les fonctions membres
[static] QString QQuickStyle::name()
Renvoie le nom du style de l'application.
Remarque : le style d'application peut être spécifié en passant l'argument de ligne de commande « -style ». Par conséquent, la fonction « name() » peut ne pas renvoyer une valeur entièrement résolue si elle est appelée avant la création d'un objet « QGuiApplication ».
[static] void QQuickStyle::setFallbackStyle(const QString &style)
Définit le style de repli de l'application sur « style ».
Remarque : le style de secours doit correspondre au nom de l'un des styles intégrés d'Qt Quick Controls, par exemple « Material ».
Remarque : le style doit être configuré avant le chargement du code QML qui importe Qt Quick Controls. Il n’est pas possible de modifier le style une fois que les types QML ont été enregistrés.
Le style de secours peut également être spécifié en définissant la variable d'environnement QT_QUICK_CONTROLS_FALLBACK_STYLE.
Voir également setStyle() et Utilisation des styles dans Qt Quick Controls.
[static] void QQuickStyle::setStyle(const QString &style)
Définit le style de l'application sur « style ».
Remarque : le style doit être configuré avant le chargement du code QML qui importe Qt Quick Controls. Il n'est pas possible de modifier le style une fois que les types QML ont été enregistrés.
Voir également ` setFallbackStyle()` et « Utilisation des styles » dans Qt Quick Controls.
© 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.
