color QML Value Type

Une valeur de couleur ARGB. Plus d'informations...

Propriétés

• a : real
• b : real
• g : real
• hslHue : real
• hslLightness : real
• hslSaturation : real
• hsvHue : real
• hsvSaturation : real
• hsvValue : real
• r : real
• valid : bool

Description détaillée

Le type color fait référence à une valeur de couleur ARGB. Elle peut être spécifiée de plusieurs manières :

• Par un SVG color name, tel que "red", "green" ou "lightsteelblue".
• Par un triplet ou un quadruplet hexadécimal de la forme "#RRGGBB" et "#AARRGGBB" respectivement. Par exemple, la couleur rouge correspond à un triplet de "#FF0000" et un bleu légèrement transparent à un quadruplet de "#800000FF".
• En utilisant les fonctions Qt.rgba(), Qt.hsva(), Qt.hsla(), Qt.darker(), Qt.lighter() ou Qt.tint().

Exemple :

Rectangle {
    color: "steelblue"
    width: 40; height: 40
}
Rectangle {
    color: "transparent"
    y: 40; width: 40; height: 40
}
Rectangle {
    color: "#FF0000"
    y: 80; width: 40; height: 40
}
Rectangle {
    color: "#800000FF"
    y: 120; width: 40; height: 40
}
Rectangle {
    color: "#00000000"    // ARGB fully transparent
    y: 160
    width: 40; height: 40
}

Un type de couleur possède des propriétés r, g, b et a qui font respectivement référence aux valeurs rouge, verte, bleue et alpha de la couleur. En outre, les propriétés hsvHue, hsvSaturation, hsvValue, hslHue, hslSaturation et hslLightness permettent d'accéder aux valeurs de couleur dans les modèles de couleurs HSV et HSL respectivement.

Text {
    color: "red"

    // prints "1 0 0 1"
    Component.onCompleted: console.log(color.r, color.g, color.b, color.a)
}

Pour tester l'égalité des valeurs de couleur, utilisez la fonction Qt.colorEqual(). Cette fonction permet de comparer avec précision les couleurs, qu'elles soient sous forme de propriété ou sous l'une des formes acceptables de spécification de chaîne de caractères.

Lors de l'intégration avec C++, notez que toute valeur QColor transmise à QML à partir de C++ est automatiquement convertie en valeur color, et vice-versa.

Ce type de valeur est fourni par l'importation QtQuick.

Référence des couleurs SVG

Le tableau suivant répertorie les couleurs SVG disponibles :

Voir également les types de valeurs QML.

Documentation sur les propriétés

a : real

Le canal de couleur Alpha du modèle RGBA. Alpha représente l'opacité de chaque pixel.

b : real

Le canal de couleur bleu du modèle RGBA.

g : real

Le canal de couleur vert du modèle RGBA.

hslHue : real

Composante de la teinte HSL de la couleur.

hslLightness : real

La composante HSL de la luminosité de la couleur.

hslSaturation : real

La composante de saturation HSL de la couleur.

hsvHue : real

La composante de la couleur HSV Hue de la couleur.

hsvSaturation : real

La composante de saturation HSV de la couleur.

hsvValue : real

La composante de la valeur HSV de la couleur.

r : real

Le canal de couleur rouge du modèle RGBA.

valid : bool

Renvoie True si la couleur est valide, sinon renvoie False.