- Qt 6.9
- Qt Quick
- QML Types
- Palette
- Qt 6.9.0 Reference Documentation

# Palette QML Type

Contains color groups for each QML item state. More...

Import Statement: | `import QtQuick`
Inherits: | ColorGroup

- List of all members, including inherited members

## Properties

- active : ColorGroup
- disabled : ColorGroup
- inactive : ColorGroup

## Detailed Description

A palette consists of three color groups: `active`, `disabled`, and `inactive`. The `active` color group is the default group: its colors are used for other groups if colors of these groups aren't explicitly specified.

In the following example, color is applied for all color groups:

     ApplicationWindow {
         palette.buttonText: "salmon"

         ColumnLayout {
             Button {
                 text: qsTr("Disabled button")
                 enabled: false
             }

             Button {
                 text: qsTr("Enabled button")
             }
         }
     }

It means that text color will be the same for both buttons.

In the following example, colors will be different for enabled and disabled states:

     ApplicationWindow {
         palette.buttonText: "salmon"
         palette.disabled.buttonText: "lavender"

         ColumnLayout {
             Button {
                 text: qsTr("Disabled button")
                 enabled: false
             }

             Button {
                 text: qsTr("Enabled button")
             }
         }
     }

It is also possible to specify colors like this:

     palette {
         buttonText: "red"
         button: "khaki"

         disabled {
             buttonText: "lavender"
             button: "coral"
         }
     }

This approach is especially convenient when you need to specify a whole palette with all color groups; but as with the other cases above, the colors that are not specified are initialized from SystemPalette, or potentially the Qt Quick Controls style, if one is in use.

Note: Some Controls styles use some palette colors, but many styles use independent colors.

See also Window::palette, Item::palette, Popup::palette, and SystemPalette.

## Property Documentation

active : ColorGroup

The Active group is used for windows that are in focus.

See also QPalette::Active.

disabled : ColorGroup

The Disabled group is used for elements that are disabled for some reason.

See also QPalette::Disabled.

inactive : ColorGroup

The Inactive group is used for windows that have no keyboard focus.

See also QPalette::Inactive.