Qt Quick Fichier de configuration des contrôles
Qt Quick Les contrôles prennent en charge un fichier de configuration spécial, qtquickcontrols2.conf, qui est intégré aux ressources d'une application.
Le fichier de configuration peut spécifier le style préféré et certains attributs spécifiques au style. L'exemple suivant indique que le style préféré est le style Matériel. En outre, lorsque l'application est exécutée avec le style Material, son thème est clair et les couleurs d'accentuation et primaires sont respectivement sarcelle et gris bleu. Toutefois, si l'application est exécutée avec le style Universal, la couleur d'accentuation est le rouge et le thème approprié est choisi en fonction des couleurs du thème du système.
[Controls] Style=Material [Universal] Theme=System Accent=Red [Material] Theme=Light Accent=Teal Primary=BlueGrey
Il 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 des contrôles
Les valeurs suivantes peuvent être spécifiées dans une section Controls du fichier de configuration :
| Variable | Variable Description |
|---|---|
Style | Spécifie le style avec lequel l'application doit être exécutée. La valeur peut être le nom d'un des styles intégrés ou d'un style personnalisé. |
FallbackStyle | Indique 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, le style Basic est utilisé. |
Section Imagine
Le tableau suivant répertorie les valeurs qui peuvent être utilisées pour configurer le style Imagine dans une section Imagine du fichier de configuration :
| Variable | Variable Description |
|---|---|
Path | Spécifie le chemin d'accès au répertoire contenant 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: [Imagine] Path=:/imagine-assets Pour spécifier un chemin relatif vers un répertoire local : [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 |
Section Matériau
Le tableau suivant répertorie les valeurs qui peuvent être utilisées pour configurer le style Material dans une section Material du fichier de configuration :
| Variable | Variable Description |
|---|---|
Theme | Spécifie le thème par défaut de la section Matériel. La valeur peut être l'un des thèmes disponibles, par exemple "Dark". |
Variant | Spécifie la variante du style 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 |
Accent | Spé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". |
Primary | Spé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". |
Foreground | Spé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". |
Background | Spé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". |
Section universelle
Le tableau suivant répertorie les valeurs qui peuvent être utilisées pour configurer le style universel dans une section Universal du fichier de configuration :
| Variable | Variable Description |
|---|---|
Theme | Spécifie le thème universel par défaut. La valeur peut être l'un des thèmes disponibles, par exemple "Dark". |
Accent | Spécifie la couleur d'accentuation par défaut du style Universal. 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". |
Foreground | Spé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". |
Background | Spé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". |
Configuration des polices
La police par défaut font peut être spécifiée dans un sous-groupe Font dans la section de chaque style du fichier de configuration :
[Basic] Font\Family=Open Sans Font\PixelSize=20
Attributs de police pris en charge :
| Variable | Variable Description |
|---|---|
Family | La police font family. |
PointSize | La police point size. |
PixelSize | L'adresse pixel size. |
StyleHint | Le style hint. Valeurs disponibles : SansSerif, Helvetica, Serif, Times, TypeWriter, Courier, OldEnglish, Decorative, Monospace, Fantasy, Cursive. |
Weight | Le weight. Qt XML utilise une échelle de pondération de 1 à 1000 compatible avec OpenType. Un poids de 1 sera fin, tandis que 1000 sera extrêmement noir. Poids prédéfinis disponibles : Thin (100), ExtraLight (200), Light (300), Normal (400), Medium (500), DemiBold (600), Bold (700), ExtraBold (800), Black (900). |
Style | Les valeurs disponibles sont style: StyleNormal, StyleItalic, StyleOblique. |
Configuration de la palette
La palette par défaut palette 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=#212121
Voir le type QML Palette pour plus d'informations.
Utilisation du fichier de configuration dans un projet
Pour que les contrôles Qt Quick puissent 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 fichier pour charger le fichier de configuration. Il est possible de fournir un fichier de configuration différent pour différentes plates-formes et locales. Voir la documentation de QFileSelector pour plus de détails.
Enfin, le fichier .qrc doit être répertorié dans le fichier de construction 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 construction
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.
