ColorGroup QML Type
La palette de couleurs par rôle. En savoir plus...
Propriétés
- accent : color
(since 6.6) - alternateBase : color
- base : color
- brightText : color
- button : color
- buttonText : color
- dark : color
- highlight : color
- highlightedText : color
- light : color
- link : color
- linkVisited : color
- mid : color
- midlight : color
- placeholderText : color
(since 6.2) - shadow : color
- text : color
- toolTipBase : color
- toolTipText : color
- window : color
- windowText : color
Signaux
- changed()
Description détaillée
Le type ColorGroup sert à définir un ensemble de couleurs associées à des rôles spécifiques. Bien qu'un ColorGroup n'ait pas d'apparence visuelle, il définit les couleurs utilisées pour personnaliser les éléments affichés.
Les valeurs par défaut des couleurs correspondent aux couleurs du groupe actif de l'QPalette construit par défaut.
Le code suivant permet de créer un groupe de couleurs avec certaines couleurs spécifiées :
ColorGroup {
alternateBase: "red"
base: "green"
}Le type ` Palette ` expose des groupes de couleurs pour chaque état d’élément QML.
Documentation des propriétés
accent : color [since 6.6]
Une couleur qui contraste généralement avec les couleurs de base, window et button, ou qui les met en valeur. Elle correspond généralement au choix de personnalisation du bureau effectué par l’utilisateur. La mise en forme des composants interactifs en est un cas d’utilisation typique. Sauf indication contraire, la valeur par défaut est highlight.
Cette propriété a été introduite dans Qt 6.6.
alternateBase : color
Utilisée comme couleur d'arrière-plan alternative dans les vues d'éléments où les couleurs des lignes alternent.
base : color
Elle sert principalement de couleur d'arrière-plan pour les contrôles des éditeurs de texte et les vues d'éléments. Elle est généralement blanche ou d'une autre couleur claire.
brightText : color
Une couleur de texte très différente de windowText, qui offre un bon contraste avec, par exemple, dark. Généralement utilisée pour le texte devant être affiché là où text, windowText ou buttonText offriraient un contraste insuffisant, comme sur les boutons mis en évidence.
button : color
Couleur d'arrière-plan générale des boutons. Cet arrière-plan peut différer de celui défini dans ` window `, car certains styles nécessitent une couleur d'arrière-plan différente pour les boutons.
buttonText : color
Une couleur de premier plan utilisée avec la couleur « palette ».
dark : color
Une couleur de premier plan utilisée avec la couleur « palette ».
highlight : color
Une couleur permettant d'indiquer un élément sélectionné ou l'élément actif.
highlightedText : color
Une couleur de texte qui contraste avec highlight.
light : color
Plus léger qu’ button.
link : color
Couleur du texte utilisée pour les liens hypertextes.
linkVisited : color
Couleur du texte utilisée pour les liens déjà visités.
mid : color
Entre palette.button et dark.
midlight : color
Entre button et light.
placeholderText : color [since 6.2]
Utilisée comme couleur de remplacement pour les champs modifiables à une seule ligne.
Cette propriété a été introduite dans Qt 6.2.
shadow : color
Une couleur très foncée.
text : color
Couleur de premier plan utilisée avec base. Elle est généralement identique à celle de windowText; dans ce cas, elle doit offrir un bon contraste avec window et base.
toolTipBase : color
Utilisée comme couleur d'arrière-plan pour les infobulles.
toolTipText : color
Utilisée comme couleur de premier plan pour les infobulles.
window : color
Une couleur d'arrière-plan générale.
windowText : color
Une couleur générale pour le premier plan.
Documentation sur les signaux
changed()
Un signal supplémentaire indique que l'état actuel de ce groupe de couleurs a été modifié. Cela signifie généralement qu'une des couleurs a été modifiée.
Remarque : le gestionnaire correspondant est onChanged.
© 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.