color QML Value Type

Un valor de color ARGB. Más...

Propiedades

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

Descripción detallada

El tipo color se refiere a un valor de color ARGB. Puede especificarse de varias maneras:

• Mediante un SVG color name, como "red", "green" o "lightsteelblue".
• Mediante un triplete o cuádruple hexadecimal de la forma "#RRGGBB" y "#AARRGGBB" respectivamente. Por ejemplo, el color rojo corresponde a un triplete de "#FF0000" y un azul ligeramente transparente a un cuadrado de "#800000FF".
• Mediante las funciones Qt.rgba(), Qt.hsva(), Qt.hsla(), Qt.darker(), Qt.lighter() o Qt.tint().

Ejemplo:

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 tipo de color tiene las propiedades r, g, b y a que se refieren a los valores rojo, verde, azul y alfa del color, respectivamente. Además, las propiedades hsvHue, hsvSaturation, hsvValue, hslHue, hslSaturation y hslLightness permiten acceder a los valores de color en los modelos de color HSV y HSL respectivamente.

Text {
    color: "red"

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

Para comprobar la igualdad de los valores de color, utilice la función Qt.colorEqual(). Esto permite que los colores se comparen con precisión tanto si están en forma de propiedad como en cualquiera de las formas de especificación de cadena aceptables.

Cuando se integre con C++, tenga en cuenta que cualquier valor QColor pasado a QML desde C++ se convierte automáticamente en un valor color, y viceversa.

Este tipo de valor lo proporciona la importación QtQuick.

Referencia de colores SVG

En la tabla siguiente se enumeran los colores SVG disponibles:

Véase también Tipos de valor QML.

Documentación de propiedades

a : real

El canal de color Alfa del modelo RGBA. Alfa representa la opacidad de cada píxel.

b : real

El canal de color Azul del modelo RGBA.

g : real

El canal de color Verde del modelo RGBA.

hslHue : real

El componente de color HSL hue del color.

hslLightness : real

El componente de color HSL Luminosidad del color.

hslSaturation : real

El componente de color HSL Saturación del color.

hsvHue : real

El componente de color HSV Hue del color.

hsvSaturation : real

El componente de color HSV Saturación del color.

hsvValue : real

El componente de color HSV Value del color.

r : real

El canal de color Rojo del modelo RGBA.

valid : bool

Devuelve True si el color es válido; en caso contrario devuelve False.