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 Arten angegeben werden:

• Durch einen „ SVG color name “-Wert, wie beispielsweise „red“, „green“ oder „lightsteelblue“.
• Durch ein hexadezimales Triplet oder Quad in der Form „ "#RRGGBB" “ bzw. „ "#AARRGGBB" “. Beispielsweise entspricht die Farbe Rot einem Triplet der Form „ "#FF0000" “ und ein leicht transparentes Blau einem Quad der Form „ "#800000FF" “.
• Verwenden Sie die 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 verfügt über die Eigenschaften r, g, b und a, die sich jeweils auf die Rot-, Grün-, Blau- und Alpha-Werte der Farbe beziehen. Darüber hinaus ermöglichen die Eigenschaften `hsvHue`, `hsvSaturation`, `hsvValue`, `hslHue`, `hslSaturation` und `hslLightness` den Zugriff auf Farbwerte in den Farbmodellen HSV bzw. HSL.

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 lassen sich Farben genau vergleichen, unabhängig davon, ob sie in Form von Eigenschaften oder in einer der zulässigen Zeichenfolgenformate vorliegen.

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

Dieser Werttyp wird durch den Import „ QtQuick “ bereitgestellt.

SVG-Farbreferenz

Die folgende Tabelle listet die verfügbaren SVG-Farben auf:

Siehe auch QML-Werttypen.

Dokumentation zu Eigenschaften

a : real

Der Alpha-Farbkanal des RGBA-Modells. Alpha gibt die Deckkraft jedes einzelnen Pixels an.

b : real

Der Blau-Farbkanal des RGBA-Modells.

g : real

Der Grünkanal des RGBA-Modells.

hslHue : real

Die HSL-Farbkomponente „Hue“ (Farbton) der Farbe.

hslLightness : real

Die HSL-Farbkomponente „Helligkeit“ der Farbe.

hslSaturation : real

Die HSL-Farbkomponente „Sättigung“ der Farbe.

hsvHue : real

Die HSV-Hue-Komponente der Farbe.

hsvSaturation : real

Die HSV-Sättigungskomponente der Farbe.

hsvValue : real

Die HSV-Wert-Farbkomponente der Farbe.

r : real

Der Rot-Farbkanal des RGBA-Modells.

valid : bool

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