Sur cette page

Palette QML Type

Contient les groupes de couleurs pour chaque état d'un élément QML. En savoir plus...

Import Statement: import QtQuick
Inherits:

ColorGroup

Propriétés

Description détaillée

Une palette se compose de trois groupes de couleurs : active, disabled et inactive. Le groupe de couleurs active est le groupe par défaut : ses couleurs sont utilisées pour les autres groupes si les couleurs de ces derniers ne sont pas explicitement spécifiées.

Dans l'exemple suivant, la couleur est appliquée à tous les groupes de couleurs :

ApplicationWindow {
    palette.buttonText: "salmon"

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

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

Cela signifie que la couleur du texte sera la même pour les deux boutons.

Dans l'exemple suivant, les couleurs seront différentes selon que les boutons sont activés ou désactivés :

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

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

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

Il est également possible de spécifier les couleurs comme suit :

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

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

Cette approche est particulièrement pratique lorsque vous devez spécifier une palette complète avec tous les groupes de couleurs ; mais comme dans les autres cas ci-dessus, les couleurs qui ne sont pas spécifiées sont initialisées à partir de SystemPalette, ou éventuellement du styleQt Quick Controls , si celui-ci est utilisé.

Remarque : certains styles de contrôles utilisent des couleurs de la palette, mais de nombreux styles utilisent des couleurs indépendantes.

Voir également Window::palette, Item::palette, Popup::palette et SystemPalette.

Documentation sur les propriétés

active : ColorGroup

Le groupe « Active » est utilisé pour les fenêtres actives.

Voir également QPalette::Active.

disabled : ColorGroup

Le groupe « Disabled » est utilisé pour les éléments qui sont désactivés pour une raison quelconque.

Voir également QPalette::Disabled.

inactive : ColorGroup

Le groupe « Inactif » est utilisé pour les fenêtres qui n'ont pas le focus clavier.

Voir également QPalette::Inactive.

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