W3cubDocs

/Qt

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.

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.2/qml-qtquick-palette.html