Sur cette page

ColorGroup QML Type

L'ensemble des couleurs par rôle. Plus d'informations...

Import Statement: import QtQuick
Inherits:

QtObject

Inherited By:

Palette

Propriétés

Signaux

Description détaillée

Le type ColorGroup est utilisé pour définir un ensemble de couleurs ayant certains rôles. Bien qu'un ColorGroup n'ait pas d'apparence visuelle, il définit les couleurs utilisées pour personnaliser les éléments rendus.

Les valeurs par défaut des couleurs sont égales aux couleurs du groupe actif de QPalette.

Le code suivant peut être utilisé pour 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 sur les propriétés

accent : color [since 6.6]

Une couleur qui contraste ou complète généralement les couleurs base, window, et button. Elle représente généralement le choix de l'utilisateur en matière de personnalisation du bureau. Le style des composants interactifs est un cas d'utilisation typique. Sauf si elle est explicitement définie, 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 avec des couleurs de ligne alternées.

base : color

Utilisée principalement comme couleur d'arrière-plan pour les contrôles de l'éditeur de texte et les vues d'éléments. Il s'agit généralement du blanc ou d'une autre couleur claire.

brightText : color

Une couleur de texte très différente de windowText, qui contraste bien avec, par exemple, dark. Elle est généralement utilisée pour le texte qui doit être dessiné là où text, windowText ou buttonText donnerait un mauvais contraste, comme sur les boutons en surbrillance.

button : color

La couleur générale de l'arrière-plan du bouton. Cet arrière-plan peut être différent de window, car certains styles exigent 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 pour indiquer un élément sélectionné ou l'élément en cours.

highlightedText : color

Une couleur de texte qui contraste avec highlight.

light : color

Plus léger que button.

Couleur de texte utilisée pour les hyperliens.

linkVisited : color

Couleur de texte utilisée pour les hyperliens 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 d'insertion pour les champs éditables à ligne unique.

Cette propriété a été introduite dans Qt 6.2.

shadow : color

Une couleur très foncée.

text : color

La couleur de premier plan utilisée avec base. Elle est généralement identique à celle de windowText, auquel 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 de premier plan.

Documentation sur les signaux

changed()

Ce signal supplémentaire indique que l'état actuel de ce groupe de couleurs a été modifié. En général, cela signifie que l'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.