Sur cette page

Variables d’environnement prises en charge dans Qt Quick Controls

Cette page contient la liste de toutes les variables d'environnement prises en charge par Qt Quick Controls. Ces variables d'environnement sont principalement destinées à des fins de test, mais elles peuvent également servir à définir des valeurs par défaut à l'échelle du système.

VariableDescription
QT_QUICK_CONTROLS_STYLESpécifie le style par défaut d'Qt Quick Controls . La valeur peut être soit l'un des styles intégrés, par exemple "Material", soit un style personnalisé tel que "MyStyle".
QT_QUICK_CONTROLS_FALLBACK_STYLESpécifie un style de secours pour les styles personnalisés. La valeur peut correspondre à l'un des styles intégrés, par exemple "Material",
QT_QUICK_CONTROLS_CONFSpécifie l'emplacement du fichier de configurationQt Quick Controls . Par défaut, le fichier de configuration est chargé à partir des ressources de l'application dans ":/qtquickcontrols2.conf".
QT_QUICK_CONTROLS_HOVER_ENABLEDSpécifie si Qt Quick Controls utilise hover effects. La valeur peut être définie sur 0 ou 1 pour désactiver ou activer les effets de survol, respectivement.

Imaginez des variables d’environnement spécifiquesau style:

VariableDescription
QT_QUICK_CONTROLS_IMAGINE_PATHSpécifie le chemin d'accès au répertoire contenant les ressources du style Imagine. Si ce paramètre n'est pas spécifié, les ressources intégrées sont utilisées.

Par exemple, pour spécifier le chemin d’accès à un répertoire stocké dans le système de ressources:

QT_QUICK_CONTROLS_IMAGINE_PATH=:/imagine-assets

Pour spécifier un chemin d'accès relatif vers un répertoire local :

QT_QUICK_CONTROLS_IMAGINE_PATH=imagine-assets

Remarque : en raison d'une contrainte technique, le chemin ne doit pas être nommé « imagine » s'il est relatif au fichier « qtquickcontrols2.conf ».

QT_QUICK_CONTROLS_IMAGINE_SMOOTHDéfinissez la variable d'environnement 1 pour activer la mise à l'échelle fluide des images 9-patch. Cette variable d'environnement a été ajoutée dans Qt 6.5.

Variables d’environnement spécifiquesau style Material:

VariableDescription
QT_QUICK_CONTROLS_MATERIAL_THEMESpécifie le thème Material par défaut. La valeur peut correspondre à l’un des thèmes disponibles, par exemple "Dark".
QT_QUICK_CONTROLS_MATERIAL_VARIANTSpécifie la variante Material. Le Material Design propose deux variantes : une variante normale conçue pour les appareils tactiles, et une variante « dense » destinée aux ordinateurs de bureau. La variante « dense » utilise des tailles plus petites pour les contrôles et leurs polices.

La valeur peut être "Normal" ou "Dense".

QT_QUICK_CONTROLS_MATERIAL_ACCENTSpécifie la couleur d'accent par défaut de Material. La valeur peut être n'importe quelle couleur de la palette color, mais il est recommandé d'utiliser l'une des couleurs Material prédéfinies, par exemple "Teal".
QT_QUICK_CONTROLS_MATERIAL_PRIMARYSpécifie la couleur principale par défaut de Material. La valeur peut être n’importe quelle couleur color, mais il est recommandé d’utiliser l’une des couleurs Material prédéfinies, par exemple "BlueGrey".
QT_QUICK_CONTROLS_MATERIAL_FOREGROUNDSpécifie la couleur de premier plan par défaut de Material. La valeur peut être n’importe quelle couleur color, ou l’une des couleurs Material prédéfinies, par exemple "Brown".
QT_QUICK_CONTROLS_MATERIAL_BACKGROUNDSpécifie la couleur d’arrière-plan par défaut du matériau. La valeur peut être n’importe quelle couleur color ou l’une des couleurs prédéfinies du matériau, par exemple "Grey".

Variables d’environnement spécifiquesau style universel:

VariableDescription
QT_QUICK_CONTROLS_UNIVERSAL_THEMESpécifie le thème Universal par défaut. La valeur peut être l'un des thèmes disponibles, par exemple "Dark".
QT_QUICK_CONTROLS_UNIVERSAL_ACCENTSpécifie la couleur d'accent Universal par défaut. La valeur peut être n'importe quelle couleur color, mais il est recommandé d'utiliser l'une des couleurs Universal prédéfinies, par exemple "Violet".
QT_QUICK_CONTROLS_UNIVERSAL_FOREGROUNDSpécifie la couleur de premier plan Universal par défaut. La valeur peut être n'importe quelle couleur de la palette color, ou l'une des couleurs Universal prédéfinies, par exemple "Brown".
QT_QUICK_CONTROLS_UNIVERSAL_BACKGROUNDSpécifie la couleur d'arrière-plan Universal par défaut. La valeur peut être n'importe quelle couleur color ou l'une des couleurs Universal prédéfinies, par exemple "Steel".

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