color QML Value Type

一个 ARGB 颜色值。更多...

属性

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

详细说明

color 类型指的是一种ARGB颜色值。可以通过多种方式指定：

• 使用SVG color name ，例如“red”、“green”或“lightsteelblue”。
• 通过十六进制三元组或四元组，格式分别为"#RRGGBB" 和"#AARRGGBB" 。例如，红色对应三元组"#FF0000" ，而略带透明的蓝色对应四元组"#800000FF" 。
• 使用Qt.rgba()、Qt.hsva()、Qt.hsla()、Qt.darker()、Qt.lighter() 或Qt.tint() 函数。

示例：

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
}

颜色类型具有r、g、b 和a属性，它们分别表示颜色的红、绿、蓝和透明度值。 此外，hsvHue、hsvSaturation、hsvValue、hslHue、hslSaturation 和hslLightness属性可分别用于访问 HSV 和 HSL 颜色模型中的颜色值。

Text {
    color: "red"

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

要测试颜色值是否相等，请使用 `Qt.colorEqual()` 函数。这使得无论颜色是以属性形式存在，还是以任何可接受的字符串指定形式存在，都能进行精确比较。

在与 C++ 集成时，请注意，从 C++ 传递到 QML 的任何QColor 值都会自动转换为color 值，反之亦然。

该值类型由QtQuick 导入提供。

SVG 颜色参考

下表列出了可用的SVG 颜色：

另请参阅 QML 值类型。

属性文档

a : real

RGBA 模型中的 Alpha 颜色通道。Alpha 表示每个像素的不透明度。

b : real

RGBA 模型中的蓝色通道。

g : real

RGBA 模型中的绿色通道。

hslHue : real

该颜色的 HSL 色相分量。simplified Chinese (Mainland)

hslLightness : real

该颜色的 HSL 明度色分量。

hslSaturation : real

该颜色的HSL饱和度色分量。

hsvHue : real

该颜色的 HSV 色相分量。H.S.V. 色相值

hsvSaturation : real

该颜色的 HSV 饱和度色分量。

hsvValue : real

该颜色的 HSV Value 色值分量。

r : real

RGBA 模型中的红色通道。

valid : bool

如果颜色有效，则返回True ；否则返回False 。