Sur cette page

QQuickStyle Class

La classe QQuickStyle permet de configurer le style de l'application. Plus d'informations...

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 des contrôles Qt Quick.

#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 le chargement de QML qui importe les contrôles Qt Quick. Il n'est pas possible de modifier le style après l'enregistrement des types QML.

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é, voir Création d'un style personnalisé. Les styles personnalisés n'ont pas besoin d'implémenter tous les contrôles. Par défaut, le système de style utilise le style Basic comme solution de repli pour les contrôles qu'un style personnalisé ne fournit pas. Il est possible de spécifier un style de repli différent pour personnaliser ou étendre l'un des styles intégrés.

QQuickStyle::setStyle("MyStyle");
QQuickStyle::setFallbackStyle("Material");

Voir aussi Styling Qt Quick Controls.

Documentation sur les fonctions membres

[static] QString QQuickStyle::name()

Renvoie le nom du style d'application.

Remarque : le style d'application peut être spécifié en passant un argument de ligne de commande -style. Par conséquent, name() peut ne pas renvoyer une valeur entièrement résolue s'il est appelé avant la construction d'un QGuiApplication.

[static] void QQuickStyle::setFallbackStyle(const QString &style)

Définit le style de repli de l'application à style.

Remarque : le style de repli doit être le nom de l'un des styles intégrés des contrôles Qt Quick, par exemple "Material".

Remarque : le style doit être configuré avant le chargement de QML qui importe les contrôles Qt Quick. Il n'est pas possible de modifier le style après l'enregistrement des types QML.

Le style de repli peut également être spécifié en définissant la variable d'environnement QT_QUICK_CONTROLS_FALLBACK_STYLE.

Voir également setStyle() et Utiliser des styles dans les contrôles Qt Quick .

[static] void QQuickStyle::setStyle(const QString &style)

Définit le style de l'application à style.

Remarque : le style doit être configuré avant de charger le QML qui importe les contrôles Qt Quick. Il n'est pas possible de modifier le style après l'enregistrement des types QML.

Voir également setFallbackStyle() et Utiliser des styles dans les contrôles Qt Quick .

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