Sur cette page

ColorGroup QML Type

La palette de couleurs par rôle. En savoir plus...

Import Statement: import QtQuick
Inherits:

QtObject

Inherited By:

Palette

Propriétés

Signaux

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.

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.