Sur cette page

Palette QML Type

Contient des groupes de couleurs pour chaque état de l'élément QML. Plus d'informations...

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 groupes 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 pour les états activé et désactivé :

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 de cette manière :

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

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

Cette approche est particulièrement pratique lorsque vous devez spécifier une palette entière 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 potentiellement à partir du style de contrôleQt Quick , s'il en existe un.

Remarque : certains styles de contrôle utilisent certaines 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 Actif est utilisé pour les fenêtres qui sont au centre de l'attention.

Voir également QPalette::Active.

disabled : ColorGroup

Le groupe Désactivé 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 aussi 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.