Style Imagine

Le style Imagine est basé sur des images configurables. Plus d'informations...

Déclaration d'importation : import QtQuick.Controls.Imagine 2.12
Depuis : Qt 5.10

Propriétés attachées

  • path: chaîne de caractères

Description détaillée

Le style Imagine est basé sur des images. Le style est livré avec un ensemble d'images par défaut, mais les images peuvent être facilement modifiées en fournissant un répertoire d'images utilisant une convention de nommage prédéfinie.

Le style Imagine avec les images par défaut

Pour exécuter une application avec le style Imagine, voir Utilisation des styles dans Qt Quick Controls.

Noms de fichiers

Les fichiers images sont nommés selon la convention suivante :

<control>-<element>-<states>

Les sections <control> et <element> sont obligatoires, mais la section <states> est facultative. Par exemple, si un seul fichier nommé "button-background.9.png" est fourni pour Button, il sera utilisé pour chaque État pris en charge par Button. Il appartient au développeur de décider de l'ensemble des états pour lesquels il fournira des images. Toutefois, il est recommandé de fournir des images pour les états de contrôle les plus courants, tels que disabled, pressed, etc. Cela garantit que les contrôles interactifs se comportent visuellement comme l'utilisateur final s'y attend.

Référence de l'élément

Le tableau suivant répertorie les éléments pris en charge pour chaque contrôle, ainsi que les états possibles pour cet élément et l'extension de fichier attendue. Un élément est une image qui représente une certaine partie visuelle du contrôle. Par exemple, l'élément "background" de Button représente son élément background.

ContrôleÉlémentÉtatsExtension
ApplicationWindowarrière-planactif.9.png (ou .png)
BusyIndicatoranimationdésactivée, en cours, en miroir, survolée.webp
arrière-plancomme ci-dessus.webp
Buttonarrière-plandésactivé, pressé, vérifié, vérifiable, focalisé, mis en évidence, plat, reflété, survolé.9.png
CheckBoxarrière-plandésactivé, enfoncé, coché, partiellement coché, focalisé, miroir, survolé.9.png (ou .png)
indicateuridem que ci-dessus.png
CheckDelegatearrière-plandésactivé, appuyé, coché, partiellement coché, focalisé, mis en évidence, reflété, survolé.9.png (ou .png)
indicateuridem que ci-dessus.png
ComboBoxarrière-plandésactivé, appuyé, modifiable, ouvert, focalisé, reflété, survolé, plat.9.png (ou .png)
indicateuridem que ci-dessus.png
popupcomme ci-dessus.9.png (ou .png)
DelayButtonarrière-plandésactivé, enfoncé, vérifié, vérifiable, focalisé, reflété, survolé.9.png (ou .png)
progressionidem que ci-dessus.9.png (ou .png)
masqueidem que ci-dessus.9.png (ou .png)
Dialarrière-plan1désactivé, appuyé, focalisé, reflété, survolé.9.png (ou .png)
poignéeidem que ci-dessus.9.png (ou .png)
Dialogarrière-planmodal, dim.9.png (ou .png)
titreidem que ci-dessus.9.png (ou .png)
incrustationmodal.9.png (ou .png)
DialogButtonBoxarrière-plandésactivé, miroir.9.png (ou .png)
Drawerarrière-planmodal, dim, top, left, right, bottom.9.png (ou .png)
superpositionmodal.9.png (ou .png)
Framearrière-plandésactivé, miroir.9.png (ou .png)
GroupBoxarrière-plandésactivé, miroir.9.png (ou .png)
titremême que ci-dessus.9.png (ou .png)
ItemDelegatearrière-plandésactivé, appuyé, focalisé, mis en évidence, reflété, survolé.9.png (ou .png)
Labelarrière-plandésactivé, réfléchi, survolé.9.png (ou .png)
Menuarrière-planmodal, dim.9.png (ou .png)
superpositionmodal.9.png (ou .png)
MenuItemflèchedésactivée, pressée, cochée, focalisée, mise en évidence, reflétée, survolée.png
arrière-plancomme ci-dessus.9.png (ou .png)
indicateurcomme ci-dessus.png
MenuSeparatorarrière-plandésactivé, en miroir.9.png (ou .png)
séparateurcomme ci-dessus.9.png (ou .png)
Pagearrière-plandésactivé, en miroir.9.png (ou .png)
PageIndicatorarrière-plandésactivé, réfléchi, survolé.9.png (ou .png)
déléguédésactivé, pressé, courant, miroir, survolé.png
Panearrière-plandésactivé, reflété.9.png (ou .png)
Popuparrière-planmodal, dim.9.png (ou .png)
superpositionmodal.9.png (ou .png)
ProgressBaranimationdésactivée, miroir, survolée.png
arrière-plandésactivé, indéterminé, miroir, survolé.9.png (ou .png)
masquecomme ci-dessus.9.png (ou .png)
progressionidem que ci-dessus.9.png (ou .png)
RadioButtonarrière-plandésactivé, appuyé, coché, focalisé, reflété, survolé.9.png (ou .png)
indicateuridem que ci-dessus.png
RadioDelegatearrière-plandésactivé, appuyé, coché, focalisé, mis en évidence, reflété, survolé.9.png (ou .png)
indicateuridem que ci-dessus.png
RangeSliderarrière-planvertical, horizontal, désactivé, focalisé, miroir, survolé.9.png (ou .png)
RangeSliderprogressionidem que ci-dessus.9.png (ou .png)
poignéepremier, second, vertical, horizontal, désactivé, appuyé, focalisé, reflété, survolé.png
RoundButtonarrière-plandésactivé, pressé, coché, contrôlable, focalisé, mis en évidence, plat, réfléchi, survolé.9.png (ou .png)
ScrollBararrière-planvertical, horizontal, désactivé, interactif, appuyé, reflété, survolé.9.png (ou .png)
poignéeidem que ci-dessus.9.png (ou .png)
ScrollIndicatorarrière-planvertical, horizontal, désactivé, miroir, survolé.9.png (ou .png)
poignéecomme ci-dessus.9.png (ou .png)
ScrollViewarrière-plandésactivé, en miroir.9.png (ou .png)
Sliderarrière-planvertical, horizontal, désactivé, appuyé, focalisé, réfléchi, survolé.9.png (ou .png)
poignéeidem que ci-dessus.9.png (ou .png)
progressionidem que ci-dessus.9.png (ou .png)
SpinBoxarrière-plandésactivé, modifiable, focalisé, reflété, survolé.9.png (ou .png)
éditeurdésactivé, focalisé, miroir, survolé.9.png (ou .png)
indicateurhaut, bas, désactivé, éditable, pressé, focalisé, reflété, survolé.9.png (ou .png)
StackViewarrière-plandésactivé, réfléchi.9.png (ou .png)
SwipeDelegatearrière-plandésactivé, appuyé, focalisé, mis en évidence, reflété, survolé.9.png (ou .png)
SwipeViewarrière-planvertical, horizontal, désactivé, interactif, focalisé, miroir.9.png (ou .png)
Switcharrière-plandésactivé, appuyé, coché, focalisé, miroir, survolé.9.png (ou .png)
poignéeidem que ci-dessus.9.png (ou .png)
indicateuridem que ci-dessus.9.png (ou .png)
SwitchDelegatearrière-plandésactivé, appuyé, coché, focalisé, mis en évidence, reflété, survolé.9.png (ou .png)
poignéeidem que ci-dessus.9.png (ou .png)
indicateuridem que ci-dessus.9.png (ou .png)
TabBararrière-plandésactivé, en-tête, pied de page, miroir.9.png (ou .png)
TabButtonarrière-plandésactivé, appuyé, coché, focalisé, réfléchi, survolé.9.png (ou .png)
TextAreaarrière-plandésactivé, focalisé, miroir, survolé.9.png (ou .png)
TextFieldarrière-plandésactivé, focalisé, miroir, survolé.9.png (ou .png)
ToolBararrière-plandésactivé, en-tête, pied de page, miroir.9.png (ou .png)
ToolButtonarrière-plandésactivé, pressé, vérifié, vérifiable, focalisé, mis en évidence, plat, reflété, survolé.9.png (ou .png)
ToolSeparatorarrière-planvertical, horizontal, désactivé, réfléchi.9.png (ou .png)
séparateurcomme ci-dessus.9.png (ou .png)
ToolTiparrière-plan.9.png (ou .png)
Tumblerarrière-plandésactivé, focalisé, miroir, survolé.9.png (ou .png)

Note : 1) Le cadran de style Imagine ne prend pas encore en charge les propriétés startAngle et endAngle qui ont été introduites dans Qt 6.6, et utilise à la place une image d'arrière-plan fixe.

Exemples d'actifs

Le tableau suivant présente des exemples d'éléments (tirés des éléments par défaut du style Imagine) pour tous les contrôles. La liste n'est pas exhaustive, car tous les éléments n'ont pas besoin d'assets, mais elle peut servir de guide lors de la création de vos propres assets.

Le modèle à partir duquel ces éléments ont été exportés est disponible en tant que projet Sketch.

ContrôleÉlémentÉtatsActifNotes
ApplicationWindowarrière-plan

Voir note de bas de page 1
superposition

Voir note de bas de page 1
superpositionmodal

Voir note de bas de page 1
Buttonarrière-plan

arrière-planhandicapés

arrière-planfocalisé

arrière-planpressé

arrière-planvérifié

arrière-planvérifié, désactivé

arrière-planvérifié, ciblé

arrière-planvérifié, survolé

arrière-plansurligné

arrière-planen surbrillance, désactivé

arrière-planmis en évidence, focalisé

arrière-planmis en évidence, survolé

arrière-planen surbrillance, appuyé

arrière-planen surbrillance, coché

arrière-plansurvolé

arrière-planplat

arrière-planplat, désactivé

arrière-planplat, survolé

arrière-planplat, appuyé

arrière-planplat, coché

CheckBoxindicateur

indicateurdésactivé

indicateurappuyé

indicateurvérifié

indicateurvérifié, pressé

indicateurcoché, survolé

indicateurcoché, focalisé

indicateurpartiellement, vérifié

indicateurpartiellement, vérifié, pressé

indicateurpartiellement, vérifié, ciblé

indicateurpartiellement, coché, survolé

indicateurfocalisé

indicateursurvolé

CheckDelegatearrière-plan

arrière-plandésactivé

arrière-planpressé

arrière-planfocalisé

arrière-plansurvolé

indicateur

indicateurdésactivé

indicateurappuyé

indicateurvérifié

indicateurvérifié, pressé

indicateurvérifié, focalisé

indicateurcoché, survolé

indicateurfocalisé

indicateursurvolé

indicateurpartiellement, coché

indicateurpartiellement, vérifié, pressé

indicateurpartiellement, vérifié, ciblé

indicateurpartiellement, coché, survolé

indicateursurvolé

ComboBoxarrière-plan

arrière-plandésactivé

arrière-planfocalisé

arrière-plansurvolé

arrière-planpressé

arrière-planouvert

arrière-planmodifiable

arrière-planmodifiable, ciblé

arrière-planmodifiable, désactivé

indicateur

indicateurdésactivé

indicateurmodifiable

indicateurmodifiable, désactivé

indicateurmodifiable, en miroir

indicateuréditable, miroir, désactivé

popup

DelayButtonarrière-plan

arrière-plandésactivé

arrière-plandésactivé, vérifié

arrière-planciblé

arrière-planenfoncé

arrière-planvérifié

arrière-planvérifié, focalisé

arrière-plancoché, survolé

arrière-plansurvolé

progression

progressiondésactivé

masque

Dialarrière-plan

arrière-plandésactivé

arrière-planfocalisé

poignée

poignéedésactivé

poignéeciblée

poignéefocalisée, pressée

poignéefocalisé, survolé

poignéeappuyé

poignéesurvolée

Dialogarrière-plan

superposition

Voir note de bas de page 1
superpositionmodal

Voir note de bas de page 1
DialogButtonBoxarrière-plan

Drawerarrière-planà gauche

arrière-plandroite

arrière-planhaut

arrière-planen bas

superposition

Voir note de bas de page 1
superpositionmodal

Voir note de bas de page 1
Framearrière-plan

GroupBoxarrière-plan

titre

ItemDelegatearrière-plan

arrière-plandésactivé

arrière-planenfoncé

arrière-planfocalisé

arrière-plansurvolé

arrière-planmis en évidence

Menuarrière-plan

MenuItemarrière-plan

arrière-planen surbrillance

flèche

flèchereflété

flèchedésactivée

flècheen miroir, désactivé

indicateur

indicateurdésactivé

indicateurenfoncé

indicateurvérifié

indicateurvérifié, pressé

indicateurvérifié, focalisé

indicateurcoché, survolé

indicateurfocalisé

indicateursurvolé

MenuSeparatorséparateur

Pagearrière-plan

Voir note de bas de page 1
PageIndicatordélégué

déléguédésactivé

déléguédésactivé, actuel

déléguépressé

déléguéactuel

Panearrière-plan

Popuparrière-plan

Voir note de bas de page 1
superposition

Voir note de bas de page 1
superpositionmodal

ProgressBararrière-plan

progression

masque

RadioButtonindicateur

indicateurdésactivé

indicateuractivé

indicateurvérifié

indicateurvérifié, focalisé

indicateurcoché, survolé

indicateurcoché, appuyé

indicateurfocalisé

indicateursurvolé

RadioDelegatearrière-plan

arrière-plandésactivé

arrière-planenfoncé

arrière-planfocalisé

arrière-plansurvolé

indicateur

indicateurdésactivé

indicateuractivé

indicateurvérifié

indicateurvérifié, focalisé

indicateurcoché, survolé

indicateurcoché, appuyé

indicateurfocalisé

indicateursurvolé

RangeSliderarrière-planvertical

arrière-planhorizontal

progressionvertical

progressionvertical, désactivé

progressionhorizontal

progressionhorizontale, désactivée

poignée

poignéedésactivé

poignéefocalisé

poignéefocalisé, survolé

poignéefocalisé, appuyé

poignéesurvolé

poignéeenfoncée

RoundButtonarrière-plan

arrière-plandésactivé

arrière-plandésactivé, vérifié

arrière-planciblé

arrière-planenfoncé

arrière-planvérifié

arrière-planvérifié, focalisé

arrière-plancoché, survolé

arrière-planmis en évidence

arrière-planen surbrillance, appuyé

arrière-planen surbrillance, focalisé

arrière-planmis en évidence, survolé

arrière-plansurvolé

ScrollBarpoignée

poignéedésactivé

poignéeinteractive

poignéeinteractive, désactivée

poignéeinteractive, pressée

poignéeinteractive, survolée

ScrollIndicatorpoignée

Sliderarrière-planvertical

arrière-planhorizontal

progressionvertical

progressionvertical, désactivé

progressionhorizontal

progressionhorizontale, désactivée

poignée

poignéedésactivé

poignéefocalisé

poignéefocalisé, survolé

poignéefocalisé, appuyé

poignéesurvolé

poignéeenfoncée

SpinBoxarrière-plan

arrière-plandésactivé

arrière-planfocalisé

arrière-planéditable

indicateuren haut

indicateuren haut, désactivé

indicateurvers le haut, appuyé

indicateurvers le haut, focalisé

indicateurvers le haut, en miroir

indicateuren haut, survolé

indicateuren haut, modifiable

indicateuren haut, éditable, pressé

indicateuren haut, éditable, focalisé

indicateurvers le haut, éditable, reflété

indicateuren haut, éditable, survolé

indicateurvers le bas

indicateurvers le bas, désactivé

indicateurvers le bas, appuyé

indicateurvers le bas, focalisé

indicateurvers le bas, en miroir

indicateurvers le bas, survolé

indicateurvers le bas, éditable

indicateuren bas, éditable, pressé

indicateuren bas, éditable, focalisé

indicateurvers le bas, éditable, reflété

indicateuren bas, éditable, survolé

SwipeDelegatearrière-plan

arrière-plandésactivé

arrière-planpressé

arrière-planfocalisé

arrière-plansurvolé

Switchindicateur

indicateurdésactivé

indicateurappuyé

indicateurvérifié

indicateurvérifié, ciblé

indicateurcoché, survolé

indicateurcoché, appuyé

indicateurfocalisé

indicateursurvolé

poignée

poignéedésactivé

poignéepressé

SwitchDelegatearrière-plan

arrière-plandésactivé

arrière-planpressé

arrière-planfocalisé

arrière-plansurvolé

indicateur

indicateurdésactivé

indicateurappuyé

indicateurvérifié

indicateurvérifié, ciblé

indicateurcoché, survolé

indicateurcoché, appuyé

indicateurfocalisé

indicateursurvolé

poignée

poignéedésactivé

TabBararrière-plan

TabButtonarrière-plan

arrière-plandésactivé

arrière-planpressé

arrière-planvérifié

arrière-plansurvolé

arrière-plandésactivé, coché

TextAreaarrière-plan

arrière-plandésactivé

arrière-planfocalisé

TextFieldarrière-plan

arrière-plandésactivé

arrière-planfocalisé

ToolBararrière-plan

ToolButtonarrière-plan

arrière-plandésactivé, coché

arrière-planfocalisé

arrière-planpressé

arrière-planvérifié

arrière-planvérifié, ciblé

arrière-planvérifié, survolé

arrière-plansurvolé

ToolSeparatorséparateurhorizontal

séparateurvertical

ToolTiparrière-plan

1 Une image 1x1 contenant une couleur, étirée pour remplir le contrôle.

Images 9-Patch

Le style Imagine utilise des images en 9 parties pour permettre aux concepteurs de contrôler la façon dont un élément particulier réagit au redimensionnement. Voici un exemple d'image en 9 points représentant une page Button's background, ainsi qu'une version agrandie (pour mieux voir les lignes en 9 points) :

Le contenu de l'image a une largeur de 44 pixels et une hauteur de 32 pixels. Chaque image 9-patch doit être entourée d'une ligne d'un pixel d'épaisseur (collectivement appelée "lignes 9-patch"), de sorte que la taille réelle de l'image est de 46 pixels de large sur 34 pixels de haut. Notez que les lignes de 9 patchs doivent avoir une épaisseur d'un pixel, quel que soit le DPI cible de l'image. Par exemple, les lignes de 9 patchs pour button-background.9.png et button-background@2x.9.png doivent toutes deux avoir une épaisseur d'un pixel.

Les lignes de 9 patchs doivent être noires et les autres zones doivent être transparentes ou blanches :

Zones extensibles

Les lignes de 9 hachures situées sur les bords supérieur et gauche déterminent les parties de l'image qui seront étirées lors d'un redimensionnement.

Vous trouverez ci-dessous des exemples de redimensionnement de l'image 9-patch à une fois et demie sa taille d'origine dans différentes dimensions :

Remarquez que les coins arrondis conservent leur taille d'origine, car ils se trouvent en dehors de la zone des lignes.

Zones de remplissage

Les lignes de 9 points sur les bords droit et inférieur déterminent l'espace disponible pour le contrôle contentItem, ce qui signifie qu'il peut également être considéré comme contrôlant le padding. Pour un diagramme illustrant le remplissage, voir Control Layout.

Vous trouverez ci-dessous d'autres exemples de redimensionnement de l'image 9-patch, mais cette fois-ci en démontrant le fonctionnement des lignes 9-patch de remplissage.

Le site contentItem peut prendre toute la place dont il a besoin dans les zones ombrées. Si les lignes de remplissage sont supprimées, l'image contentItem prendra toute la place dont elle a besoin sans dépasser les zones extensibles.

Zones d'insertion

Dans certains cas, il est nécessaire qu'un contrôle ait une ombre portée, par exemple. Cependant, si nous devions ajouter une ombre portée au bouton ci-dessus, cela affecterait sa taille, ce qui pose des problèmes à la fois pour la mise en page et pour les limites d'entrée de la souris/du toucher.

Les zones d'insertion permettent de résoudre ce problème en indiquant au contrôle qu'une certaine zone de l'image 9-patch doit se trouver à l'extérieur du contrôle :

Dans l'image ci-dessous, la ligne en pointillés représente la zone cliquable du bouton, ainsi que l'espace qu'il occupera dans une mise en page. L'ombre est marquée par la zone rayée située derrière elle :

Exportation d'images 9-Patch

Divers éditeurs vectoriels et bitmap peuvent être utilisés pour créer des images 9-patch adaptées au style Imagine. Les sections suivantes expliquent brièvement le processus d'exportation pour chaque éditeur, et la dernière section explique comment s'assurer que les images exportées sont conformes à 9-patch.

Affinity Designer

Voir la documentation sur les paramètres d'exportation d' Affinity.

Adobe Illustrator

Voir la documentation sur le panneau d'exportation des actifs d' Adobe.

Adobe Photoshop

Voir la documentation d'Adobe sur la génération d'images à partir de calques.

Inkscape

L'extension d'exportation Inkscape 9-Patch peut être utilisée pour exporter des ressources avec Inkscape.

Esquisse

Voir la documentation sur l 'exportation de Sketch.

Qt Quick Controls fournit également un plugin pour Sketch qui corrige automatiquement l'épaisseur des lignes de 9 patchs après l'exportation des ressources. Pour installer ce fichier, double-cliquez dessus. Une fois que Sketch a confirmé que le plugin d'exportation 9-patch a été installé, le plugin traitera automatiquement les images lors de leur exportation.

Correction des lignes 9-patch

Lors de l'exportation d'images 9-patch dans plusieurs variantes DPI (@2x, @3x, etc.), les lignes 9-patch seront généralement mises à l'échelle avec l'image. Il existe plusieurs façons de résoudre ce problème, mais l'approche la plus simple consiste peut-être à utiliser l'outil mogrify d'ImageMagick. L'outil dispose d'une fonction -shave qui peut être utilisée pour recadrer l'image afin de réduire l'épaisseur des lignes 9-patch :

mogrify -shave 1x1 -path path/to/images *@2x.9.png
mogrify -shave 2x2 -path path/to/images *@3x.9.png
mogrify -shave 3x3 -path path/to/images *@4x.9.png

Les images DPI normales (celles sans le préfixe @Nx ) ne sont pas affectées, il n'est donc nécessaire d'exécuter la commande que sur les images destinées à des écrans DPI élevés.

Images animées

Les formats d'images animées WebP et GIF sont pris en charge par le style Imagine.

Personnalisation

Chemin d'accès

Le style Imagine permet de personnaliser le chemin utilisé pour la sélection des images. Le chemin peut être spécifié pour n'importe quelle fenêtre ou élément, et il se propage automatiquement aux enfants de la même manière que fonts. Dans l'exemple suivant, la fenêtre et les trois boutons radio apparaissent avec des images sombres (fichiers situés dans "qrc:/themes/dark").

import QtQuick 2.12
import QtQuick.Controls 2.12
import QtQuick.Controls.Imagine 2.12

ApplicationWindow {
    visible: true

    Imagine.path: "qrc:/themes/dark"

    Column {
        anchors.centerIn: parent

        RadioButton { text: qsTr("Small") }
        RadioButton { text: qsTr("Medium"); checked: true }
        RadioButton { text: qsTr("Large") }
    }
}

Outre la spécification du chemin d'accès en QML, il est également possible de le spécifier via une variable d'environnement ou dans un fichier de configuration. Les attributs spécifiés en QML sont prioritaires sur toutes les autres méthodes.

Fichier de configuration
VariableDescription de la variable
PathSpécifie le chemin d'accès au répertoire contenant les éléments de style Imagine. S'il n'est pas spécifié, les ressources intégrées sont utilisées.

Par exemple, pour spécifier un chemin d'accès à 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 qtquickcontrols2.conf.

Voir Qt Quick Controls Configuration File pour plus de détails sur le fichier de configuration.

Variables d'environnement
VariableDescription de la variable
QT_QUICK_CONTROLS_IMAGINE_PATHSpécifie le chemin d'accès au répertoire contenant les éléments de style Imagine. S'il n'est pas spécifié, les ressources intégrées sont utilisées.

Par exemple, pour spécifier un 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 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.

Voir Variables d'environnement supportées dans Qt Quick Controls pour la liste complète des variables d'environnement supportées.

Palette

Le style Imagine prend en charge la personnalisation de la palette via la propriété palette et le fichier qtquickcontrols2.conf. Comme pour les autres styles, les palette roles exacts utilisés par le style Imagine dépendent du style. Cependant, comme la plupart de l'apparence visuelle des contrôles (par exemple : les arrière-plans) sont gérés par des images, seuls les rôles qui sont typiquement utilisés pour le texte auront un effet.

Police

Les polices personnalisées peuvent être définies via la propriété font et le fichier de configuration.

Dépendance

Le style Imagine doit être importé séparément pour avoir accès aux attributs qui lui sont spécifiques. Il convient de noter qu'indépendamment des références au style Imagine, le même code d'application s'exécute avec n'importe quel autre style. Les attributs spécifiques à Imagine n'ont d'effet que lorsque l'application est exécutée avec le style Imagine.

Si le style Imagine est importé dans un fichier QML qui est toujours chargé, le style Imagine doit être déployé avec l'application afin de pouvoir exécuter l'application quel que soit le style avec lequel elle est exécutée. L'utilisation de sélecteurs de fichiers permet d'apporter des modifications spécifiques à un style sans créer de dépendance absolue à l'égard d'un style.

Voir aussi Stylisation Qt Quick Controls

Documentation sur les propriétés attachées

Imagine.path: string

Cette propriété jointe contient le chemin d'accès à l'image...

Button {
    Imagine.path: "qrc:/themes/dark"
}

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