Qt Quick Controls Fichier de configuration
Qt Quick Controls prend en charge un fichier de configuration spécial, qtquickcontrols2.conf, qui est intégré aux ressources d'une application.
Ce fichier de configuration permet de spécifier le style préféré ainsi que certains attributs propres à ce style. L’exemple suivant indique que le style préféré est le style « Material ». De plus, lorsque l’application est exécutée avec le style « Material », son thème est « clair » et les couleurs d’accent et principale sont respectivement le bleu sarcelle et le gris-bleu. En revanche, si l’application est exécutée avec le style « Universal », la couleur d’accent est le rouge et le thème approprié est choisi en fonction des couleurs du thème système.
[Controls]
Style=Material
[Universal]
Theme=System
Accent=Red
[Material]
Theme=Light
Accent=Teal
Primary=BlueGreyIl est possible de spécifier un emplacement personnalisé pour le fichier de configuration à l'aide de la variable d'environnement QT_QUICK_CONTROLS_CONF.
Section « Controls »
Les valeurs suivantes peuvent être spécifiées dans la section « Controls » du fichier de configuration :
| Variable | Description |
|---|---|
Style | Spécifie le style à utiliser pour l'exécution de l'application. La valeur peut être le nom d'un des styles intégrés ou d'un style personnalisé. |
FallbackStyle | Spécifie le style à utiliser pour les contrôles qui ne sont pas implémentés. Le style doit être l’un des styles intégrés. Par défaut, c’est le style « Basic » qui est utilisé. |
Section Imagine
Le tableau suivant répertorie les valeurs pouvant être utilisées pour configurer le style « Imagine » dans la section « Imagine » du fichier de configuration :
| Variable | Description |
|---|---|
Path | Spécifie le chemin d'accès au répertoire contenant les ressources du style Imagine. Si aucune valeur n'est spécifiée, 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: Pour spécifier un chemin d'accès relatif vers un répertoire local : Remarque : en raison d’une contrainte technique, le chemin ne doit pas s’appeler « imagine » s’il est relatif au fichier |
Section « Material »
Le tableau suivant répertorie les valeurs pouvant être utilisées pour configurer le style « Material » dans une section « Material » du fichier de configuration :
| Variable | Description |
|---|---|
Theme | Spécifie le thème Material par défaut. La valeur peut correspondre à l’un des thèmes disponibles, par exemple "Dark". |
Variant | Spé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 |
Accent | Spé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". |
Primary | Spé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". |
Foreground | Spécifie la couleur de premier plan par défaut de Material. La valeur peut être n’importe quel color, ou l’une des couleurs prédéfinies de Material, par exemple "Brown". |
Background | Spécifie la couleur d'arrière-plan par défaut de Material. La valeur peut être n'importe quelle couleur color ou l'une des couleurs prédéfinies de Material, par exemple "Grey". |
Section « Universal »
Le tableau suivant répertorie les valeurs pouvant être utilisées pour configurer le style « Universal » dans une section Universal du fichier de configuration :
| Variable | Description |
|---|---|
Theme | Spécifie le thème « Universal » par défaut. La valeur peut être l’un des thèmes disponibles, par exemple "Dark". |
Accent | Spécifie la couleur d'accent par défaut de Universal. 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". |
Foreground | Spé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". |
Background | Spé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". |
Configuration des polices
L'font e par défaut peut être spécifiée dans un sous-groupe Font au sein de la section de chaque style dans le fichier de configuration :
[Basic]
Font\Family=Open Sans
Font\PixelSize=20Attributs de police pris en charge :
| Variable | Description |
|---|---|
Family | L'font family. |
PointSize | L'point size. |
PixelSize | L'pixel size. |
StyleHint | style hint. Valeurs disponibles : SansSerif, Helvetica, Serif, Times, TypeWriter, Courier, OldEnglish, Decorative, Monospace, Fantasy, Cursive. |
Weight | weight. Qt utilise une échelle de graisses allant de 1 à 1000, compatible avec OpenType. Une graisse de type 1 sera fine, tandis que 1000 sera extrêmement noire. Grades prédéfinis disponibles : Thin (100), ExtraLight (200), Light (300), Normal (400), Medium (500), DemiBold (600), Bold (700), ExtraBold (800), Black (900). |
Style | L'style. Valeurs disponibles : StyleNormal, StyleItalic, StyleOblique. |
Configuration de la palette
L'palette par défaut peut être configurée pour chaque style à l'aide du sous-groupe Palette dans le fichier de configuration. Le sous-groupe Palette peut être défini de deux manières différentes :
[Fusion]
Palette\Window=#dedede
Palette\WindowText=#212121Voir le type QML « Palette » pour plus d’informations.
Utilisation du fichier de configuration dans un projet
Pour permettre à Qt Quick Controls de trouver le fichier de configuration, celui-ci doit être intégré aux ressources de l’application à l’aide du système de ressources Qt. Voici un exemple de fichier .qrc:
<!DOCTYPE RCC><RCC version="1.0">
<qresource prefix="/">
<file>qtquickcontrols2.conf</file>
</qresource>
</RCC>Remarque : Qt Quick Controls utilise un sélecteur de fichiers pour charger le fichier de configuration. Il est possible de fournir un fichier de configuration différent pour chaque plateforme et chaque paramètre régional. Consultez la documentation d’ QFileSelector pour plus de détails.
Enfin, le fichier ` .qrc ` doit être répertorié dans le fichier de compilation de l’application. Par exemple :
set(CMAKE_AUTORCC ON)
qt_add_executable(my_app
application.qrc
main.cpp
...
)RESOURCES = application.qrc
...Voir aussi : Intégration du système de compilation
Informations connexes
© 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.
