color QML Value Type

Ein ARGB-Farbwert. Mehr...

Eigenschaften

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

Ausführliche Beschreibung

Der Typ color bezieht sich auf einen ARGB-Farbwert. Er kann auf verschiedene Weise angegeben werden:

• Durch einen SVG color name, wie "rot", "grün" oder "hellblau".
• Durch eine hexadezimale Dreier- oder Vierergruppe in der Form "#RRGGBB" bzw. "#AARRGGBB". Zum Beispiel entspricht die Farbe Rot einem Triplett von "#FF0000" und ein leicht transparentes Blau einem Quad von "#800000FF".
• Mit den Funktionen Qt.rgba(), Qt.hsva(), Qt.hsla(), Qt.darker(), Qt.lighter() oder Qt.tint().

Beispiel:

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
}

Ein Farbtyp hat die Eigenschaften r, g, b und a, die sich jeweils auf die Rot-, Grün-, Blau- und Alpha-Werte der Farbe beziehen. Zusätzlich ermöglichen die Eigenschaften hsvHue, hsvSaturation, hsvValue, hslHue, hslSaturation und hslLightness den Zugriff auf Farbwerte im HSV- bzw. HSL-Farbmodell.

Text {
    color: "red"

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

Um Farbwerte auf Gleichheit zu prüfen, verwenden Sie die Funktion Qt.colorEqual(). Damit können Farben genau verglichen werden, unabhängig davon, ob sie in Form von Eigenschaften oder in einer der akzeptablen Formen der Stringspezifikation vorliegen.

Bei der Integration mit C++ ist zu beachten, dass jeder QColor Wert, der von C++ an QML übergeben wird, automatisch in einen color Wert umgewandelt wird und umgekehrt.

Dieser Wertetyp wird durch den QtQuick import bereitgestellt.

SVG-Farbreferenz

In der folgenden Tabelle sind die verfügbaren SVG-Farben aufgeführt:

Siehe auch QML-Wertetypen.

Dokumentation der Eigenschaft

a : real

Der Alpha-Farbkanal des RGBA-Modells. Alpha stellt die Deckkraft der einzelnen Pixel dar.

b : real

Der blaue Farbkanal des RGBA-Modells.

g : real

Der grüne Farbkanal des RGBA-Modells.

hslHue : real

Die HSL-Farbkomponente für den Farbton der Farbe.

hslLightness : real

Die HSL-Farbkomponente "Helligkeit" der Farbe.

hslSaturation : real

Die HSL-Farbkomponente Sättigung der Farbe.

hsvHue : real

Die HSV-Farbkomponente Hue der Farbe.

hsvSaturation : real

Die HSV-Sättigungs-Farbkomponente der Farbe.

hsvValue : real

Die HSV-Wert-Farbkomponente der Farbe.

r : real

Der rote Farbkanal des RGBA-Modells.

valid : bool

Gibt True zurück, wenn die Farbe gültig ist; andernfalls wird False zurückgegeben.