- Qt 6.5
- Qt Quick
- QML Types
- ColorGroup
- Qt 6.5.2 Reference Documentation

# ColorGroup QML Type

The set of colors by roles. More...

Import Statement: | import QtQuick
Inherits: | QtObject

- List of all members, including inherited members

## Properties

- 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
- shadow : color
- text : color
- toolTipBase : color
- toolTipText : color
- window : color
- windowText : color

## Signals

- changed()

## Detailed Description

The ColorGroup type is used to define a set of colors with certain roles. Although a ColorGroup has no visual appearance, it defines colors used to customize rendered items.

Default values of colors are equal to active group colors of default-constructed `QPalette`.

The following code can be used to create a color group with some colors specified:

     ColorGroup {
         alternateBase: "red"
         base: "green"
     }

The Palette type exposes color groups for each QML item state.

## Property Documentation

alternateBase : color

Used as the alternate background color in item views with alternating row colors.

base : color

Used mostly as the background color for text editor controls and item views. It is usually white or another light color.

brightText : color

A text color that is very different from `windowText`, and contrasts well with e.g. `dark`. Typically used for text that needs to be drawn where `text`, `windowText` or `buttonText` would give poor contrast, such as on highlighted buttons.

button : color

The general button background color. This background can be different from `window` as some styles require a different background color for buttons.

buttonText : color

A foreground color used with the `palette` color.

dark : color

A foreground color used with the `palette` color.

highlight : color

A color to indicate a selected item or the current item.

highlightedText : color

A text color that contrasts with `highlight`.

light : color

Lighter than `button`.

link : color

A text color used for hyperlinks.

linkVisited : color

A text color used for already visited hyperlinks.

mid : color

Between `palette.button` and `dark`.

midlight : color

Between `button` and `light`.

[since 6.2] placeholderText : color

Used as the place holder color for editable single line fields.

This property was introduced in Qt 6.2.

shadow : color

A very dark color.

text : color

The foreground color used with `base`. This is usually the same as the `windowText`, in which case it must provide good contrast with `window` and `base`.

toolTipBase : color

Used as the background color for tooltips.

toolTipText : color

Used as the foreground color for tooltips.

window : color

A general background color.

windowText : color

A general foreground color.

## Signal Documentation

changed()

Additional signal indicates that the current state of this color group has been changed. Usually it means that one of the colors is changed.

Note: The corresponding handler is `onChanged`.