Palette QML Type

The QQuickPalette class 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. 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: "azure"
    button: "khaki"

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

This approach is convenient when you need to specify a whole palette with all color groups.

Property Documentation

active : QQuickColorGroup

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

See also QPalette::Active.


disabled : QQuickColorGroup

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

See also QPalette::Disabled.


inactive : QQuickColorGroup

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

See also QPalette::Inactive.


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