color QML Value Type

an ARGB color value. More...

Properties

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

Detailed Description

The color type refers to an ARGB color value. It can be specified in a number of ways:

• By a SVG color name, such as "red", "green" or "lightsteelblue".
• By a hexadecimal triplet or quad in the form "#RRGGBB" and "#AARRGGBB" respectively. For example, the color red corresponds to a triplet of "#FF0000" and a slightly transparent blue to a quad of "#800000FF".
• Using the Qt.rgba(), Qt.hsva(), Qt.hsla(), Qt.darker(), Qt.lighter() or Qt.tint() functions.

Example:

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
}

A color type has r, g, b, and a properties that refer to the red, green, blue and alpha values of the color, respectively. Additionally, the hsvHue, hsvSaturation, hsvValue, hslHue, hslSaturation, and hslLightness properties allow access to color values in HSV and HSL color models respectively.

Text {
    color: "red"

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

To test color values for equality, use the Qt.colorEqual() function. This allows colors to be accurately compared whether they are in property form or in any of the acceptable string specification forms.

When integrating with C++, note that any QColor value passed into QML from C++ is automatically converted into a color value, and vice-versa.

This value type is provided by the QtQuick import.

SVG Color Reference

The following table lists the available SVG colors:

See also QML Value Types.

Property Documentation