color QML Value Type

Une valeur de couleur ARGB. En savoir plus...

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. Il peut être spécifié de plusieurs façons :

• Par un nom de couleur ( SVG color name), tel que « red », « green » ou « lightsteelblue ».
• Par un triplet ou un quad hexadécimal, respectivement sous la forme "#RRGGBB" et "#AARRGGBB". Par exemple, la couleur rouge correspond à un triplet de type "#FF0000" et un bleu légèrement transparent à un quad de type "#800000FF".
• À l'aide des 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 de rouge, vert, bleu et alpha de la couleur. De plus, les propriétés hsvHue, hsvSaturation, hsvValue, hslHue, hslSaturation et hslLightness permettent d'accéder aux valeurs de couleur dans les modèles de couleur 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 vérifier si des valeurs de couleur sont égales, utilisez la fonction ` Qt.colorEqual()`. Cela permet de comparer avec précision les couleurs, qu’elles soient sous forme de propriété ou sous l’une des formes de spécification de chaîne acceptées.

Lors de l’intégration avec C++, notez que toute valeur de type ` QColor ` transmise à QML depuis C++ est automatiquement convertie en une valeur de type ` color `, et inversement.

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 aussi Types de valeurs QML.

Documentation sur les propriétés

a : real

Le canal de couleur alpha du modèle RGBA. L'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

La composante de teinte (HSL) de la couleur.

hslLightness : real

La composante de couleur « luminosité » (HSL) de la couleur.

hslSaturation : real

La composante de couleur « Saturation HSL » de la couleur.

hsvHue : real

La composante « teinte » (HSV) de la couleur.

hsvSaturation : real

La composante de couleur « saturation HSV » de la couleur.

hsvValue : real

La composante de couleur « HSV Value » 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 ».