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