Palette QML Type

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

Import Statement: import QtQuick

Properties

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.


© 2024 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.