Sur cette page

Variables d'environnement prises en charge par Qt Quick Controls

Cette page contient une liste de toutes les variables d'environnement prises en charge par Qt Quick Controls. Les variables d'environnement sont principalement destinées à des fins de test, mais elles peuvent également être utilisées pour définir les valeurs par défaut de l'ensemble du système.

VariableDescription de la variable
QT_QUICK_CONTROLS_STYLEIndique le style par défaut de Qt Quick Controls. La valeur peut être l'un des styles intégrés, par exemple "Material", ou un style personnalisé tel que "MyStyle".
QT_QUICK_CONTROLS_FALLBACK_STYLESpécifie un style de repli pour les styles personnalisés. La valeur peut être l'un des styles intégrés, par exemple "Material",
QT_QUICK_CONTROLS_CONFSpécifie l'emplacement du fichier de configuration deQt Quick Controls. Par défaut, le fichier de configuration est chargé à partir des ressources de l'application à l'adresse ":/qtquickcontrols2.conf".
QT_QUICK_CONTROLS_HOVER_ENABLEDIndique si les contrôles Qt Quick utilisent hover effects. La valeur peut être définie sur 0 ou 1 pour désactiver ou activer les effets de survol, respectivement.

Variables d'environnement spécifiques austyle Imagine:

VariableVariable Description
QT_QUICK_CONTROLS_IMAGINE_PATHSpécifie le chemin d'accès au répertoire qui contient les ressources du style Imagine. S'il n'est pas spécifié, les ressources intégrées sont utilisées.

Par exemple, pour spécifier un chemin vers un répertoire stocké dans le système de ressources:

QT_QUICK_CONTROLS_IMAGINE_PATH=:/imagine-assets

Pour spécifier un chemin relatif vers un répertoire local :

QT_QUICK_CONTROLS_IMAGINE_PATH=imagine-assets

Note : En raison d'une limitation technique, le chemin ne doit pas être nommé "imagine" s'il est relatif au fichier qtquickcontrols2.conf.

QT_QUICK_CONTROLS_IMAGINE_SMOOTHDéfinissez 1 pour permettre une mise à l'échelle en douceur des images 9-patch. Cette variable d'environnement a été ajoutée dans Qt 6.5.

Variables d'environnement spécifiques auxstyles de matériaux:

VariableDescription
QT_QUICK_CONTROLS_MATERIAL_THEMESpécifie le thème par défaut de Material. La valeur peut être l'un des thèmes disponibles, par exemple "Dark".
QT_QUICK_CONTROLS_MATERIAL_VARIANTSpécifie la variante Material. La conception matérielle comporte deux variantes : une variante normale conçue pour les appareils tactiles et une variante dense pour les ordinateurs de bureau. La variante dense utilise des contrôles et des polices de caractères de plus petite taille.

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

QT_QUICK_CONTROLS_MATERIAL_ACCENTSpécifie la couleur d'accentuation par défaut du matériau. La valeur peut être n'importe quelle color, mais il est recommandé d'utiliser l'une des couleurs matérielles prédéfinies, par exemple "Teal".
QT_QUICK_CONTROLS_MATERIAL_PRIMARYSpécifie la couleur primaire par défaut du matériau. La valeur peut être quelconque color, mais il est recommandé d'utiliser l'une des couleurs matérielles prédéfinies, par exemple "BlueGrey".
QT_QUICK_CONTROLS_MATERIAL_FOREGROUNDSpécifie la couleur d'avant-plan par défaut du matériau. La valeur peut être n'importe quelle 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 color, ou l'une des couleurs matérielles prédéfinies, par exemple "Grey".

Variables d'environnement spécifiques austyle universel:

VariableVariable Description
QT_QUICK_CONTROLS_UNIVERSAL_THEMESpécifie le thème universel 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'accentuation par défaut du style universel. La valeur peut être n'importe quelle color, mais il est recommandé d'utiliser l'une des couleurs universelles prédéfinies, par exemple "Violet".
QT_QUICK_CONTROLS_UNIVERSAL_FOREGROUNDSpécifie la couleur d'avant-plan par défaut d'Universal. La valeur peut être n'importe quelle 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 par défaut de Universal. La valeur peut être n'importe quelle 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.