QColor Class
Die Klasse „QColor“ stellt Farben auf Basis von RGB-, HSV- oder CMYK-Werten bereit. Mehr...
| Kopfzeile: | #include <QColor> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- Veraltete Mitglieder
- QColor gehört zu den Mal-Klassen.
Öffentliche Typen
| enum | NameFormat { HexRgb, HexArgb } |
| enum | Spec { Rgb, Hsv, Cmyk, Hsl, ExtendedRgb, Invalid } |
Öffentliche Funktionen
| QColor() | |
| QColor(QRgb color) | |
| QColor(QRgba64 rgba64) | |
| QColor(const QString &name) | |
| QColor(int r, int g, int b, int a = 255) | |
| QColor(QLatin1StringView name) | |
| QColor(Qt::GlobalColor color) | |
| QColor(const char *name) | |
| int | alpha() const |
| float | alphaF() const |
| int | black() const |
| float | blackF() const |
| int | blue() const |
| float | blueF() const |
| QColor | convertTo(QColor::Spec colorSpec) const |
| int | cyan() const |
| float | cyanF() const |
| QColor | darker(int factor = 200) const |
| void | getCmyk(int *c, int *m, int *y, int *k, int *a = nullptr) const |
| void | getCmykF(float *c, float *m, float *y, float *k, float *a = nullptr) const |
| void | getHsl(int *h, int *s, int *l, int *a = nullptr) const |
| void | getHslF(float *h, float *s, float *l, float *a = nullptr) const |
| void | getHsv(int *h, int *s, int *v, int *a = nullptr) const |
| void | getHsvF(float *h, float *s, float *v, float *a = nullptr) const |
| void | getRgb(int *r, int *g, int *b, int *a = nullptr) const |
| void | getRgbF(float *r, float *g, float *b, float *a = nullptr) const |
| int | green() const |
| float | greenF() const |
| int | hslHue() const |
| float | hslHueF() const |
| int | hslSaturation() const |
| float | hslSaturationF() const |
| int | hsvHue() const |
| float | hsvHueF() const |
| int | hsvSaturation() const |
| float | hsvSaturationF() const |
| int | hue() const |
| float | hueF() const |
| bool | isValid() const |
| QColor | lighter(int factor = 150) const |
| int | lightness() const |
| float | lightnessF() const |
| int | magenta() const |
| float | magentaF() const |
| QString | name(QColor::NameFormat format = HexRgb) const |
| int | red() const |
| float | redF() const |
| QRgb | rgb() const |
| QRgba64 | rgba64() const |
| QRgb | rgba() const |
| int | saturation() const |
| float | saturationF() const |
| void | setAlpha(int alpha) |
| void | setAlphaF(float alpha) |
| void | setBlue(int blue) |
| void | setBlueF(float blue) |
| void | setCmyk(int c, int m, int y, int k, int a = 255) |
| void | setCmykF(float c, float m, float y, float k, float a = 1.0) |
| void | setGreen(int green) |
| void | setGreenF(float green) |
| void | setHsl(int h, int s, int l, int a = 255) |
| void | setHslF(float h, float s, float l, float a = 1.0) |
| void | setHsv(int h, int s, int v, int a = 255) |
| void | setHsvF(float h, float s, float v, float a = 1.0) |
| void | setRed(int red) |
| void | setRedF(float red) |
| void | setRgb(int r, int g, int b, int a = 255) |
| void | setRgb(QRgb rgb) |
| void | setRgba64(QRgba64 rgba) |
| void | setRgbF(float r, float g, float b, float a = 1.0) |
| void | setRgba(QRgb rgba) |
| QColor::Spec | spec() const |
| QColor | toCmyk() const |
| QColor | toExtendedRgb() const |
| QColor | toHsl() const |
| QColor | toHsv() const |
| QColor | toRgb() const |
| int | value() const |
| float | valueF() const |
| int | yellow() const |
| float | yellowF() const |
| operator QVariant() const | |
| bool | operator!=(const QColor &color) const |
| QColor & | operator=(Qt::GlobalColor color) |
| bool | operator==(const QColor &color) const |
Statische öffentliche Mitglieder
| QStringList | colorNames() |
| QColor | fromCmyk(int c, int m, int y, int k, int a = 255) |
| QColor | fromCmykF(float c, float m, float y, float k, float a = 1.0) |
| QColor | fromHsl(int h, int s, int l, int a = 255) |
| QColor | fromHslF(float h, float s, float l, float a = 1.0) |
| QColor | fromHsv(int h, int s, int v, int a = 255) |
| QColor | fromHsvF(float h, float s, float v, float a = 1.0) |
| QColor | fromRgb(QRgb rgb) |
| QColor | fromRgb(int r, int g, int b, int a = 255) |
| QColor | fromRgba64(QRgba64 rgba64) |
| QColor | fromRgba64(ushort r, ushort g, ushort b, ushort a = USHRT_MAX) |
| QColor | fromRgbF(float r, float g, float b, float a = 1.0) |
| QColor | fromRgba(QRgb rgba) |
(since 6.4) QColor | fromString(QAnyStringView name) |
(since 6.4) bool | isValidColorName(QAnyStringView name) |
Verwandte Nicht-Mitglieder
| QRgb | |
| int | qAlpha(QRgb rgba) |
| uint | qAlpha(QRgba64 rgba64) |
| int | qBlue(QRgb rgb) |
| uint | qBlue(QRgba64 rgba64) |
| int | qGray(int r, int g, int b) |
| int | qGray(QRgb rgb) |
| int | qGreen(QRgb rgb) |
| uint | qGreen(QRgba64 rgba64) |
| QRgb | qPremultiply(QRgb rgb) |
| QRgba64 | qPremultiply(QRgba64 rgba64) |
| int | qRed(QRgb rgb) |
| uint | qRed(QRgba64 rgba64) |
| QRgb | qRgb(int r, int g, int b) |
| QRgba64 | qRgba64(quint64 c) |
| QRgba64 | qRgba64(quint16 r, quint16 g, quint16 b, quint16 a) |
| QRgb | qRgba(int r, int g, int b, int a) |
| QRgb | qUnpremultiply(QRgb rgb) |
| QRgba64 | qUnpremultiply(QRgba64 rgba64) |
| QDataStream & | operator<<(QDataStream &stream, const QColor &color) |
| QDataStream & | operator>>(QDataStream &stream, QColor &color) |
Ausführliche Beschreibung
Eine Farbe wird normalerweise anhand der RGB-Komponenten (Rot, Grün und Blau) angegeben, es ist jedoch auch möglich, sie anhand der HSV-Komponenten (Farbton, Sättigung und Helligkeit) sowie der CMYK-Komponenten (Cyan, Magenta, Gelb und Schwarz) anzugeben. Darüber hinaus kann eine Farbe mithilfe eines Farbnamens angegeben werden. Der Farbname kann ein beliebiger SVG 1.0-Farbname sein.
| RGB | HSV | CMYK |
|---|---|---|
![]() | ![]() | ![]() |
Der Konstruktor `QColor` erstellt die Farbe auf der Grundlage von RGB-Werten. Um ein `QColor`-Objekt auf der Grundlage von HSV- oder CMYK-Werten zu erstellen, verwenden Sie die Funktionen ` toHsv()` bzw. ` toCmyk()`. Diese Funktionen geben eine Kopie der Farbe im gewünschten Format zurück. Darüber hinaus erstellen die statischen Funktionen ` fromRgb()`, ` fromHsv()` und ` fromCmyk()` Farben aus den angegebenen Werten. Alternativ kann eine Farbe mithilfe der Funktion „ convertTo()“ (die eine Kopie der Farbe im gewünschten Format zurückgibt) oder einer der Funktionen „ setRgb()“, „ setHsv()“ und „ setCmyk()“ in eines der drei Formate konvertiert werden, wobei das Format dieser Farbe geändert wird. Die Funktion „ spec()“ gibt an, wie die Farbe angegeben wurde.
Eine Farbe kann festgelegt werden, indem eine RGB-Zeichenkette (z. B. „#112233“), eine ARGB-Zeichenkette (z. B. „#ff112233“) oder ein Farbname (z. B. „blue“) an die Funktion ` fromString()` übergeben wird. Die Farbnamen stammen aus den SVG 1.0-Farbnamen. Die Funktion „ name()“ gibt den Namen der Farbe im Format „#RRGGBB“ zurück. Farben können auch mit den Funktionen „ setRgb()“, „ setHsv()“ und „ setCmyk()“ festgelegt werden. Um eine hellere oder dunklere Farbe zu erhalten, verwenden Sie die Funktionen „ lighter()“ bzw. „ darker()“.
Die Funktion ` isValid()` gibt an, ob ein `QColor` überhaupt zulässig ist. Beispielsweise ist eine RGB-Farbe mit RGB-Werten außerhalb des zulässigen Bereichs unzulässig. Aus Leistungsgründen ignoriert `QColor` unzulässige Farben meist, weshalb das Ergebnis der Verwendung einer ungültigen Farbe undefiniert ist.
Die Farbkomponenten können einzeln abgerufen werden, z. B. mit ` red()`, ` hue()` und ` cyan()`. Die Werte der Farbkomponenten können auch auf einmal mit den Funktionen ` getRgb()`, ` getHsv()` und ` getCmyk()` abgerufen werden. Unter Verwendung des RGB-Farbmodells kann zusätzlich mit ` rgb()` auf die Farbkomponenten zugegriffen werden.
Es gibt mehrere verwandte Nicht-Mitglieder: ` QRgb ` ist eine Typdefinition für einen `unsigned int`, der das RGB-Wert-Triplett (r, g, b) darstellt. Beachten Sie, dass er auch einen Wert für den Alphakanal enthalten kann (weitere Informationen finden Sie im Abschnitt „ Alpha-Blended Drawing “). Die Funktionen „ qRed()“, „ qBlue()“ und „ qGreen()“ geben die jeweilige Komponente des angegebenen „ QRgb “-Werts zurück, während die Funktionen „ qRgb()“ und „ qRgba()“ das „ QRgb “-Triplett basierend auf den angegebenen Komponentenwerten erstellen und zurückgeben. Schließlich gibt die Funktion „ qAlpha()“ die Alpha-Komponente des bereitgestellten „ QRgb “ zurück, und die Funktion „ qGray()“ berechnet und gibt einen Grauwert basierend auf dem angegebenen Wert zurück.
QColor ist plattform- und geräteunabhängig.
Weitere Informationen zum Zeichnen im Allgemeinen finden Sie in der Dokumentation zum Zeichensystem.
Ganzzahlige vs. Gleitkommagenauigkeit
QColor unterstützt Gleitkommagenauigkeit und stellt Gleitkomma-Versionen aller Farbkomponentenfunktionen bereit, z. B. ` getRgbF()`, ` hueF()` und ` fromCmykF()`. Beachten Sie, dass die Komponenten als 16-Bit-Ganzzahlen gespeichert werden und es daher aufgrund von Rundungen zu geringfügigen Abweichungen zwischen den Werten, die beispielsweise mit ` setRgbF()` gesetzt werden, und den von der Funktion ` getRgbF()` zurückgegebenen Werten kommen kann.
Während die auf Ganzzahlen basierenden Funktionen Werte im Bereich von 0 bis 255 annehmen (mit Ausnahme von „ hue()“, das Werte im Bereich von 0 bis 359 erfordern muss), akzeptieren die Gleitkommafunktionen Werte im Bereich von 0,0 bis 1,0.
Zeichnen mit Alpha-Mischung
QColor unterstützt außerdem das Zeichnen von Konturen und das Ausfüllen mit Alpha-Blending. Der Alphakanal einer Farbe bestimmt den Transparenzeffekt: 0 steht für eine vollständig transparente Farbe, während 255 eine vollständig deckende Farbe darstellt. Zum Beispiel:
// Specify semi-transparent red
painter.setBrush(QColor(255, 0, 0, 127));
painter.drawRect(0, 0, width() / 2, height());
// Specify semi-transparent blue
painter.setBrush(QColor(0, 0, 255, 127));
painter.drawRect(0, 0, width(), height() / 2);Der obige Code erzeugt die folgende Ausgabe:

Der Alphakanal einer Farbe kann mit den Funktionen „ alpha()“ und „ setAlpha()“ abgerufen und gesetzt werden, wenn sein Wert eine Ganzzahl ist, sowie mit „ alphaF()“ und „ setAlphaF()“, wenn sein Wert ein Float-Wert ist. Standardmäßig ist der Alphakanal auf 255 (undurchsichtig) gesetzt. Um alle RGB-Farbkomponenten (einschließlich des Alphakanals) in einem Schritt abzurufen und festzulegen, verwenden Sie die Funktionen „ rgba “ () und „ setRgba “ ().
Vordefinierte Farben
Im Namespace „ QColorConstants “ gibt es 20 vordefinierte QColor-Objekte, darunter Schwarz, Weiß, Primär- und Sekundärfarben, dunklere Varianten dieser Farben sowie drei Graustufen. Darüber hinaus definiert der Namespace „ QColorConstants::Svg “ QColor-Objekte für die Standard-SVG-Farbschlüsselwörter.

Die Farben „ QColorConstants::Color0 “, „ QColorConstants::Color1 “ und „ QColorConstants::Transparent “ werden für spezielle Zwecke verwendet.
QColorConstants::Color0 (Pixelwert Null) und QColorConstants::Color1 (Pixelwert ungleich Null) sind Sonderfarben für das Zeichnen in QBitmaps. Das Zeichnen mit QColorConstants::Color0 setzt die Bitmap-Bits auf 0 (transparent; d. h. Hintergrund), und das Zeichnen mit c{QColorConstants::Color1} setzt die Bits auf 1 (undurchsichtig; d. h. Vordergrund).
QColorConstants::Transparent wird verwendet, um ein transparentes Pixel anzugeben. Beim Zeichnen mit diesem Wert wird ein Pixelwert verwendet, der für das zugrunde liegende, verwendete Pixelformat geeignet ist.
Aus historischen Gründen stehen die 20 vordefinierten Farben auch in der Aufzählung ` Qt::GlobalColor ` zur Verfügung.
Schließlich erkennt QColor eine Vielzahl von Farbnamen (als Zeichenketten); die statische Funktion ` colorNames()` gibt ein ` QStringList ` mit den Farbnamen zurück, die QColor kennt.
Das erweiterte RGB-Farbmodell
Das erweiterte RGB-Farbmodell, auch als scRGB-Farbraum bekannt, entspricht dem RGB-Farbmodell, erlaubt jedoch Werte unter 0,0 und über 1,0. Dadurch lassen sich Farben darstellen, die andernfalls außerhalb des Bereichs des RGB-Farbraums lägen, wobei für Farben innerhalb des RGB-Farbraums weiterhin dieselben Werte verwendet werden.
Das HSV-Farbmodell
Das RGB-Modell ist hardwareorientiert. Seine Darstellung entspricht weitgehend dem, was die meisten Monitore anzeigen. Im Gegensatz dazu stellt HSV Farben auf eine Weise dar, die der menschlichen Farbwahrnehmung besser entspricht. So lassen sich beispielsweise die Beziehungen „stärker als“, „dunkler als“ und „das Gegenteil von“ in HSV leicht ausdrücken, während dies in RGB wesentlich schwieriger ist.
HSV hat, genau wie RGB, drei Komponenten:
- H für „Hue“ (Farbton) liegt im Bereich von 0 bis 359, wenn die Farbe chromatisch (nicht grau) ist, oder ist bedeutungslos, wenn sie grau ist. Es stellt Winkelgrade auf dem den meisten Menschen vertrauten Farbkreis dar. Rot entspricht 0 (Grad), Grün 120 und Blau 240.

- S für die Sättigung (Saturation) liegt im Bereich von 0 bis 255; je größer der Wert, desto kräftiger ist die Farbe. Graustufige Farben haben eine Sättigung nahe 0; sehr kräftige Farben haben eine Sättigung nahe 255.

- V, für Wert, liegt im Bereich von 0 bis 255 und steht für die Helligkeit der Farbe. 0 ist Schwarz; 255 ist so weit wie möglich von Schwarz entfernt.

Hier sind einige Beispiele: Reines Rot hat H=0, S=255, V=255; ein dunkles Rot, das leicht in Richtung Magenta tendiert, könnte H=350 (entspricht -10), S=255, V=180 haben; ein graustichiges Hellrot könnte H etwa 0 (etwa 350–359 oder 0–10), S etwa 50–100 und V=255 haben.
Qt gibt für achromatische Farben einen Farbtonwert von -1 zurück. Wenn Sie einen zu großen Farbtonwert übergeben, passt Qt diesen in den zulässigen Bereich an. Die Farbtöne 360 oder 720 werden als 0 behandelt; der Farbton 540 wird als 180 behandelt.
Zusätzlich zum Standard-HSV-Modell bietet Qt einen Alphakanal zur Darstellung von „ alpha-blended drawing “.
Das HSL-Farbmodell
HSL ähnelt HSV, jedoch wird anstelle des Parameters „Value“ in HSL ein Parameter „Lightness“ verwendet, der etwas anders auf die Helligkeit der Farbe abgebildet wird.
Ebenso entspricht der HSL-Sättigungswert im Allgemeinen nicht dem HSV-Sättigungswert für dieselbe Farbe. ` hslSaturation()` liefert den HSL-Sättigungswert der Farbe, während ` saturation()` und ` hsvSaturation()` den HSV-Sättigungswert liefern.
Der Farbtonwert ist in HSL und HSV identisch definiert.
Das CMYK-Farbmodell
Während die Farbmodelle RGB und HSV für die Darstellung auf Computermonitoren verwendet werden, kommt das CMYK-Modell im Vierfarbdruckverfahren von Druckmaschinen und einigen Ausgabegeräten zum Einsatz.
CMYK besteht aus vier Komponenten, die alle im Bereich von 0 bis 255 liegen: Cyan (C), Magenta (M), Gelb (Y) und Schwarz (K). Cyan, Magenta und Gelb werden als subtraktive Farben bezeichnet; das CMYK-Farbmodell erzeugt Farben, indem es von einer weißen Oberfläche ausgeht und dann durch Auftragen der entsprechenden Komponenten Farbe subtrahiert. Während die Kombination von Cyan, Magenta und Gelb die Farbe Schwarz ergibt, lässt sich durch das Weglassen einer oder mehrerer dieser Farben jede andere Farbe erzeugen. In unterschiedlichen Mischungsverhältnissen können diese drei Farben das gesamte Farbspektrum erzeugen.
Das Mischen von 100 Prozent Cyan, Magenta und Gelb ergibt zwar Schwarz, das Ergebnis ist jedoch unbefriedigend, da dabei Tinte verschwendet wird, die Trocknungszeit verlängert wird und beim Drucken ein trüber Farbton entsteht. Aus diesem Grund wird im professionellen Druck Schwarz hinzugefügt, um einen satten Schwarzton zu erzielen; daher der Begriff „Vierfarbdruck“.
Zusätzlich zum Standard-CMYK-Modell bietet Qt einen Alphakanal zur Unterstützung von „ alpha-blended drawing “.
Siehe auch QPalette, QBrush und QColorConstants.
Dokumentation zu Mitgliedstypen
enum QColor::NameFormat
So formatieren Sie die Ausgabe der Funktion „ name()“
| Konstante | Wert | Beschreibung |
|---|---|---|
QColor::HexRgb | 0 | #RRGGBB Ein „#“-Zeichen, gefolgt von drei zweistelligen Hexadezimalzahlen (d. h. #RRGGBB). |
QColor::HexArgb | 1 | #AARRGGBB Ein „#“-Zeichen, gefolgt von vier zweistelligen Hexadezimalzahlen (d. h. #AARRGGBB). |
Siehe auch name().
enum QColor::Spec
Der angegebene Farbtyp: entweder RGB, erweitertes RGB, HSV, CMYK oder HSL.
| Konstante | Wert |
|---|---|
QColor::Rgb | 1 |
QColor::Hsv | 2 |
QColor::Cmyk | 3 |
QColor::Hsl | 4 |
QColor::ExtendedRgb | 5 |
QColor::Invalid | 0 |
Dokumentation der Mitgliedsfunktionen
[constexpr noexcept] QColor::QColor()
Erzeugt eine ungültige Farbe mit dem RGB-Wert (0, 0, 0). Eine ungültige Farbe ist eine Farbe, die für das zugrunde liegende Fenstersystem nicht korrekt konfiguriert ist.
Der Alpha-Wert einer ungültigen Farbe ist nicht spezifiziert.
Siehe auch ` isValid()`.
[noexcept] QColor::QColor(QRgb color)
Erzeugt eine Farbe mit dem Wert „ color “. Die Alpha-Komponente wird ignoriert und auf „solid“ gesetzt.
Siehe auch „ fromRgb()“ und „ isValid()“.
[noexcept] QColor::QColor(QRgba64 rgba64)
Erzeugt eine Farbe mit dem Wert „ rgba64 “.
Siehe auch ` fromRgba64()`.
QColor::QColor(const QString &name)
Erzeugt eine benannte Farbe auf dieselbe Weise wie ` fromString()` unter Verwendung des angegebenen ` name`.
Die Farbe bleibt ungültig, wenn die „ name “ nicht geparst werden kann.
Siehe auch fromString(), name() und isValid().
[constexpr noexcept] QColor::QColor(int r, int g, int b, int a = 255)
Erzeugt eine Farbe mit den RGB-Werten r, g, b und dem Wert des Alphakanals (Transparenz) von a.
Die Farbe wird als ungültig zurückgegeben, wenn eines der Argumente ungültig ist.
Siehe auch setRgba() und isValid().
QColor::QColor(QLatin1StringView name)
Erzeugt eine benannte Farbe auf dieselbe Weise wie fromString() unter Verwendung des angegebenen name.
Dies ist eine überladene Funktion.
Siehe auch fromString(), name() und isValid().
[noexcept] QColor::QColor(Qt::GlobalColor color)
Erzeugt eine neue Farbe mit dem Farbwert „ color “.
Dies ist eine überladene Funktion.
Siehe auch isValid() und Predefined Colors.
QColor::QColor(const char *name)
Erzeugt eine benannte Farbe auf dieselbe Weise wie ` fromString()` unter Verwendung des angegebenen ` name`.
Dies ist eine überladene Funktion.
Siehe auch fromString(), name() und isValid().
[noexcept] int QColor::alpha() const
Gibt die Alpha-Farbkomponente dieser Farbe zurück.
Siehe auch setAlpha(), alphaF() und Alpha-Blended Drawing.
[noexcept] float QColor::alphaF() const
Gibt die Alpha-Farbkomponente dieser Farbe zurück.
Siehe auch setAlphaF(), alpha() und Alpha-Blended Drawing.
[noexcept] int QColor::black() const
Gibt die Schwarzkomponente dieser Farbe zurück.
Siehe auch blackF(), getCmyk() und The CMYK Color Model.
[noexcept] float QColor::blackF() const
Gibt die Schwarzkomponente dieser Farbe zurück.
Siehe auch black(), getCmykF() und The CMYK Color Model.
[noexcept] int QColor::blue() const
Gibt die blaue Farbkomponente dieser Farbe zurück.
Siehe auch setBlue(), blueF() und getRgb().
[noexcept] float QColor::blueF() const
Gibt die blaue Farbkomponente dieser Farbe zurück.
Siehe auch „ setBlueF()“, „ blue()“ und „ getRgbF()“.
[static] QStringList QColor::colorNames()
Gibt ein ` QStringList ` zurück, das die Qt-bekannten Farbnamen enthält.
Siehe auch ` Predefined Colors`.
[noexcept] QColor QColor::convertTo(QColor::Spec colorSpec) const
Erstellt eine Kopie dieser Farbe in dem unter colorSpec angegebenen Format.
Siehe auch spec(), toCmyk(), toHsv(), toRgb() und isValid().
[noexcept] int QColor::cyan() const
Gibt die Cyan-Farbkomponente dieser Farbe zurück.
Siehe auch cyanF(), getCmyk() und The CMYK Color Model.
[noexcept] float QColor::cyanF() const
Gibt die Cyan-Farbkomponente dieser Farbe zurück.
Siehe auch cyan(), getCmykF() und The CMYK Color Model.
[noexcept] QColor QColor::darker(int factor = 200) const
Gibt eine dunklere (oder hellere) Farbe zurück, verändert dieses Objekt jedoch nicht.
Ist der Wert „ factor “ größer als 100, gibt diese Funktion eine dunklere Farbe zurück. Wird „ factor “ auf 300 gesetzt, wird eine Farbe mit einem Drittel der Helligkeit zurückgegeben. Ist „ factor “ kleiner als 100, ist die zurückgegebene Farbe heller; wir empfehlen jedoch, für diesen Zweck die Funktion „ lighter()“ zu verwenden. Ist „ factor “ gleich 0 oder negativ, ist der Rückgabewert nicht definiert.
Die Funktion konvertiert die aktuelle Farbe in HSV, dividiert die V-Komponente durch factor und konvertiert die Farbe zurück in ihre ursprüngliche Farbspezifikation.
Siehe auch lighter() und isValid().
[static] QColor QColor::fromCmyk(int c, int m, int y, int k, int a = 255)
Statische Hilfsfunktion, die ein „ QColor “ zurückgibt, das aus den angegebenen CMYK-Farbwerten erstellt wurde: c (Cyan), m (Magenta), y (Gelb), k (Schwarz) und a (Alphakanal, d. h. Transparenz).
Alle Werte müssen im Bereich von 0 bis 255 liegen.
Siehe auch toCmyk(), fromCmykF(), isValid() und The CMYK Color Model.
[static] QColor QColor::fromCmykF(float c, float m, float y, float k, float a = 1.0)
Statische Hilfsfunktion, die einen ` QColor ` zurückgibt, der aus den angegebenen CMYK-Farbwerten konstruiert wird: c (Cyan), m (Magenta), y (Gelb), k (Schwarz) und a (Alphakanal, d. h. Transparenz).
Alle Werte müssen im Bereich von 0,0 bis 1,0 liegen.
Siehe auch toCmyk(), fromCmyk(), isValid() und The CMYK Color Model.
[static] QColor QColor::fromHsl(int h, int s, int l, int a = 255)
Statische Hilfsfunktion, die ein ` QColor ` zurückgibt, das aus den HSV-Farbwerten ` h ` (Farbton), ` s ` (Sättigung), ` l ` (Helligkeit) und ` a ` (Alpha-Kanal, d. h. Transparenz) erstellt wurde.
Die Werte für s, l und a müssen alle im Bereich von 0 bis 255 liegen; der Wert für h muss im Bereich von 0 bis 359 liegen.
Siehe auch toHsl(), fromHslF(), isValid() und The HSL Color Model.
[static] QColor QColor::fromHslF(float h, float s, float l, float a = 1.0)
Statische Hilfsfunktion, die ein „ QColor “-Objekt zurückgibt, das aus den HSV-Farbwerten „ h “ (Farbton), „ s “ (Sättigung), „ l “ (Helligkeit) und „ a “ (Alpha-Kanal, d. h. Transparenz) erstellt wird.
Alle Werte müssen im Bereich von 0,0 bis 1,0 liegen.
Siehe auch toHsl(), fromHsl(), isValid() und The HSL Color Model.
[static] QColor QColor::fromHsv(int h, int s, int v, int a = 255)
Statische Hilfsfunktion, die ein ` QColor ` zurückgibt, das aus den HSV-Farbwerten ` h ` (Farbton), ` s ` (Sättigung), ` v ` (Helligkeit) und ` a ` (Alphakanal, d. h. Transparenz) konstruiert wird.
Die Werte für s, v und a müssen alle im Bereich von 0 bis 255 liegen; der Wert für h muss im Bereich von 0 bis 359 liegen.
Siehe auch toHsv(), fromHsvF(), isValid() und The HSV Color Model.
[static] QColor QColor::fromHsvF(float h, float s, float v, float a = 1.0)
Statische Hilfsfunktion, die ein „ QColor “-Objekt zurückgibt, das aus den HSV-Farbwerten „ h “ (Farbton), „ s “ (Sättigung), „ v “ (Helligkeit) und „ a “ (Alpha-Kanal, d. h. Transparenz) erstellt wurde.
Alle Werte müssen im Bereich von 0,0 bis 1,0 liegen.
Siehe auch toHsv(), fromHsv(), isValid() und The HSV Color Model.
[static noexcept] QColor QColor::fromRgb(QRgb rgb)
Statische Hilfsfunktion, die ein ` QColor ` zurückgibt, das aus dem angegebenen ` QRgb `-Wert ` rgb` erstellt wurde.
Die Alpha-Komponente von ` rgb ` wird ignoriert (d. h., sie wird automatisch auf 255 gesetzt); verwenden Sie die Funktion ` fromRgba()`), um den durch den angegebenen Wert ` QRgb ` festgelegten Alphakanal einzubeziehen.
Siehe auch ` fromRgba()`, ` fromRgbF()`, ` toRgb()` und ` isValid()`.
[static] QColor QColor::fromRgb(int r, int g, int b, int a = 255)
Statische Hilfsfunktion, die ein ` QColor ` zurückgibt, das aus den RGB-Farbwerten ` r ` (Rot), ` g ` (Grün), ` b ` (Blau) und ` a ` (Alphakanal, d. h. Transparenz) erstellt wird.
Alle Werte müssen im Bereich von 0 bis 255 liegen.
Siehe auch toRgb(), fromRgba64(), fromRgbF() und isValid().
[static noexcept] QColor QColor::fromRgba64(QRgba64 rgba64)
Statische Hilfsfunktion, die ein „ QColor “ zurückgibt, das aus dem angegebenen „ QRgba64 “-Wert „ rgba64 “ erstellt wurde.
Siehe auch fromRgb(), fromRgbF(), toRgb() und isValid().
[static noexcept] QColor QColor::fromRgba64(ushort r, ushort g, ushort b, ushort a = USHRT_MAX)
Statische Hilfsfunktion, die ein „ QColor “-Objekt zurückgibt, das aus den RGBA64-Farbwerten „ r “ (Rot), „ g “ (Grün), „ b “ (Blau) und „ a “ (Alphakanal, d. h. Transparenz) erstellt wurde.
Siehe auch fromRgb(), fromRgbF(), toRgb() und isValid().
[static] QColor QColor::fromRgbF(float r, float g, float b, float a = 1.0)
Statische Hilfsfunktion, die eine ` QColor ` zurückgibt, die aus den RGB-Farbwerten ` r ` (Rot), ` g ` (Grün), ` b ` (Blau) und ` a ` (Alphakanal, d. h. Transparenz) gebildet wird.
Der Alpha-Wert muss im Bereich von 0,0 bis 1,0 liegen. Liegt einer der anderen Werte außerhalb des Bereichs von 0,0 bis 1,0, wird das Farbmodell auf ExtendedRgb gesetzt.
Siehe auch fromRgb(), fromRgba64(), toRgb() und isValid().
[static noexcept] QColor QColor::fromRgba(QRgb rgba)
Statische Hilfsfunktion, die ein ` QColor ` zurückgibt, das aus dem angegebenen ` QRgb `-Wert ` rgba` erstellt wurde.
Im Gegensatz zur Funktion ` fromRgb()` wird der durch den angegebenen Wert ` QRgb ` festgelegte Alphakanal einbezogen.
Siehe auch fromRgb(), fromRgba64() und isValid().
[static noexcept, since 6.4] QColor QColor::fromString(QAnyStringView name)
Gibt ein RGB- QColor zurück, das aus name geparst wurde und eines der folgenden Formate haben kann:
- #RGB (R, G und B bestehen jeweils aus einer einzelnen Hexadezimalziffer)
- #RRGGBB
- #AARRGGBB (seit Version 5.2)
- #RRRGGGBBB
- #RRRRGGGGBBBB
- Ein Name aus der Liste der Farben, die in der vom World Wide Web Consortium bereitgestellten Liste der SVG-Farbschlüsselwörter definiert sind; zum Beispiel „steelblue“ oder „gainsboro“. Diese Farbnamen funktionieren auf allen Plattformen. Beachten Sie, dass diese Farbnamen nicht mit den in den „ Qt::GlobalColor “-Enumerationen definierten Namen identisch sind; so beziehen sich beispielsweise „green“ und „ Qt::green “ nicht auf dieselbe Farbe.
transparent- steht für das Fehlen einer Farbe.
Gibt eine ungültige Farbe zurück, wenn name nicht geparst werden kann.
Diese Funktion wurde in Qt 6.4 eingeführt.
Siehe auch isValidColorName().
void QColor::getCmyk(int *c, int *m, int *y, int *k, int *a = nullptr) const
Setzt die Inhalte, auf die c, m, y, k und a verweisen, auf die Cyan-, Magenta-, Gelb-, Schwarz- und Alpha-Kanal-Komponenten (Transparenz) des CMYK-Werts der Farbe.
Diese Komponenten können einzeln mit den Funktionen „ cyan()“, „ magenta()“, „ yellow()“, „ black()“ und „ alpha()“ abgerufen werden.
Siehe auch setCmyk() und The CMYK Color Model.
void QColor::getCmykF(float *c, float *m, float *y, float *k, float *a = nullptr) const
Setzt die Inhalte, auf die c, m, y, k und a verweisen, auf die Cyan-, Magenta-, Gelb-, Schwarz- und Alphakanal-Komponenten (Transparenz) des CMYK-Werts der Farbe.
Diese Komponenten können einzeln mit den Funktionen „ cyanF()“, „ magentaF()“, „ yellowF()“, „ blackF()“ und „ alphaF()“ abgerufen werden.
Siehe auch setCmykF() und The CMYK Color Model.
void QColor::getHsl(int *h, int *s, int *l, int *a = nullptr) const
Setzt die Inhalte, auf die h, s, l und a verweisen, auf die Komponenten „Farbton“, „Sättigung“, „Helligkeit“ und „Alphakanal“ (Transparenz) des HSL-Werts der Farbe.
Diese Komponenten können mithilfe der Funktionen hslHue(), hslSaturation(), lightness() und alpha() einzeln abgerufen werden.
Siehe auch getHslF(), setHsl() und The HSL Color Model.
void QColor::getHslF(float *h, float *s, float *l, float *a = nullptr) const
Setzt die Inhalte, auf die h, s, l und a verweisen, auf die Komponenten „Farbton“, „Sättigung“, „Helligkeit“ und „Alpha-Kanal“ (Transparenz) des HSL-Werts der Farbe.
Diese Komponenten können einzeln mit den Funktionen ` hslHueF()`, ` hslSaturationF()`, ` lightnessF()` und ` alphaF()` abgerufen werden.
Siehe auch getHsl(), setHslF() und The HSL Color Model.
void QColor::getHsv(int *h, int *s, int *v, int *a = nullptr) const
Setzt die Inhalte, auf die h, s, v und a verweisen, auf die Komponenten „Farbton“, „Sättigung“, „Helligkeit“ und „Alphakanal“ (Transparenz) des HSV-Werts der Farbe.
Diese Komponenten können einzeln mit den Funktionen ` hue()`, ` saturation()`, ` value()` und ` alpha()` abgerufen werden.
Siehe auch setHsv() und The HSV Color Model.
void QColor::getHsvF(float *h, float *s, float *v, float *a = nullptr) const
Setzt die Inhalte, auf die h, s, v und a verweisen, auf die Komponenten „Farbton“, „Sättigung“, „Helligkeit“ und „Alphakanal“ (Transparenz) des HSV-Werts der Farbe.
Diese Komponenten können einzeln mit den Funktionen hueF(), saturationF(), valueF() und alphaF() abgerufen werden.
Siehe auch setHsv() und The HSV Color Model.
void QColor::getRgb(int *r, int *g, int *b, int *a = nullptr) const
Setzt die Inhalte, auf die r, g, b und a verweisen, auf die Rot-, Grün-, Blau- und Alpha-Kanal-Komponenten (Transparenz) des RGB-Werts der Farbe.
Diese Komponenten können einzeln mit den Funktionen red(), green(), blue() und alpha() abgerufen werden.
Siehe auch rgb() und setRgb().
void QColor::getRgbF(float *r, float *g, float *b, float *a = nullptr) const
Setzt die Inhalte, auf die r, g, b und a verweisen, auf die Rot-, Grün-, Blau- und Alpha-Kanal-Komponenten (Transparenz) des RGB-Werts der Farbe.
Diese Komponenten können einzeln mit den Funktionen redF(), greenF(), blueF() und alphaF() abgerufen werden.
Siehe auch rgb() und setRgb().
[noexcept] int QColor::green() const
Gibt die grüne Farbkomponente dieser Farbe zurück.
Siehe auch setGreen(), greenF() und getRgb().
[noexcept] float QColor::greenF() const
Gibt die grüne Farbkomponente dieser Farbe zurück.
Siehe auch setGreenF(), green() und getRgbF().
[noexcept] int QColor::hslHue() const
Gibt die HSL-Farbtonkomponente dieser Farbe zurück.
Siehe auch hslHueF(), hsvHue(), getHsl() und The HSL Color Model.
[noexcept] float QColor::hslHueF() const
Gibt die HSL-Farbtonkomponente dieser Farbe zurück.
Siehe auch hslHue(), hsvHueF() und getHslF().
[noexcept] int QColor::hslSaturation() const
Gibt die HSL-Sättigungskomponente dieser Farbe zurück.
Siehe auch hslSaturationF(), hsvSaturation(), getHsl() und The HSL Color Model.
[noexcept] float QColor::hslSaturationF() const
Gibt die HSL-Sättigungskomponente dieser Farbe zurück.
Siehe auch hslSaturation(), hsvSaturationF(), getHslF() und The HSL Color Model.
[noexcept] int QColor::hsvHue() const
Gibt die HSV-Farbtonkomponente dieser Farbe zurück.
Siehe auch hueF(), hslHue(), getHsv() und The HSV Color Model.
[noexcept] float QColor::hsvHueF() const
Gibt die Farbkomponente „Farbton“ dieser Farbe zurück.
Siehe auch hue(), hslHueF(), getHsvF() und The HSV Color Model.
[noexcept] int QColor::hsvSaturation() const
Gibt die HSV-Sättigungskomponente dieser Farbe zurück.
Siehe auch saturationF(), hslSaturation(), getHsv() und The HSV Color Model.
[noexcept] float QColor::hsvSaturationF() const
Gibt die HSV-Sättigungskomponente dieser Farbe zurück.
Siehe auch saturation(), hslSaturationF(), getHsvF() und The HSV Color Model.
[noexcept] int QColor::hue() const
Gibt die HSV-Farbtonkomponente dieser Farbe zurück.
Die Farbe wird implizit in HSV konvertiert.
Siehe auch hsvHue(), hslHue(), hueF(), getHsv() und The HSV Color Model.
[noexcept] float QColor::hueF() const
Gibt die HSV-Farbtonkomponente dieser Farbe zurück.
Die Farbe wird implizit in HSV konvertiert.
Siehe auch hsvHueF(), hslHueF(), hue(), getHsvF() und The HSV Color Model.
[noexcept] bool QColor::isValid() const
Gibt „ true “ zurück, wenn die Farbe gültig ist; andernfalls wird „ false “ zurückgegeben.
[static noexcept, since 6.4] bool QColor::isValidColorName(QAnyStringView name)
Gibt „ true “ zurück, wenn „ name “ ein gültiger Farbname ist und zur Erstellung eines gültigen „ QColor “-Objekts verwendet werden kann; andernfalls wird „false“ zurückgegeben.
Es wird derselbe Algorithmus verwendet wie in fromString().
Diese Funktion wurde in Qt 6.4 eingeführt.
Siehe auch „ fromString()“.
[noexcept] QColor QColor::lighter(int factor = 150) const
Gibt eine hellere (oder dunklere) Farbe zurück, verändert dieses Objekt jedoch nicht.
Ist der Wert „ factor “ größer als 100, gibt diese Funktion eine hellere Farbe zurück. Wird „ factor “ auf 150 gesetzt, wird eine um 50 % hellere Farbe zurückgegeben. Ist „ factor “ kleiner als 100, ist die zurückgegebene Farbe dunkler; wir empfehlen jedoch, für diesen Zweck die Funktion „ darker()“ zu verwenden. Ist „ factor “ gleich 0 oder negativ, ist der Rückgabewert nicht definiert.
Die Funktion konvertiert die aktuelle Farbe in HSV, multipliziert die V-Komponente mit ` factor ` und konvertiert die Farbe zurück in ihre ursprüngliche Farbspezifikation.
Siehe auch „ darker()“ und „ isValid()“.
[noexcept] int QColor::lightness() const
Gibt die Helligkeitskomponente dieser Farbe zurück.
Siehe auch lightnessF() und getHsl().
[noexcept] float QColor::lightnessF() const
Gibt die Helligkeitskomponente dieser Farbe zurück.
Siehe auch value() und getHslF().
[noexcept] int QColor::magenta() const
Gibt die Magenta-Farbkomponente dieser Farbe zurück.
Siehe auch magentaF(), getCmyk() und The CMYK Color Model.
[noexcept] float QColor::magentaF() const
Gibt die Magenta-Farbkomponente dieser Farbe zurück.
Siehe auch magenta(), getCmykF() und The CMYK Color Model.
QString QColor::name(QColor::NameFormat format = HexRgb) const
Gibt den Namen der Farbe im angegebenen „ format “ zurück.
Siehe auch „ fromString()“ und „ NameFormat “.
[noexcept] int QColor::red() const
Gibt die rote Farbkomponente dieser Farbe zurück.
Siehe auch setRed(), redF() und getRgb().
[noexcept] float QColor::redF() const
Gibt die rote Farbkomponente dieser Farbe zurück.
Siehe auch setRedF(), red() und getRgbF().
[noexcept] QRgb QColor::rgb() const
Gibt den RGB-Wert der Farbe zurück. Der Alpha-Wert ist undurchsichtig.
Siehe auch setRgb(), getRgb() und rgba().
[noexcept] QRgba64 QColor::rgba64() const
Gibt den RGB64-Wert der Farbe einschließlich ihres Alpha-Werts zurück.
Bei einer ungültigen Farbe ist der Alpha-Wert der zurückgegebenen Farbe nicht festgelegt.
Siehe auch setRgba64(), rgba() und rgb().
[noexcept] QRgb QColor::rgba() const
Gibt den RGB-Wert der Farbe einschließlich ihres Alpha-Werts zurück.
Bei einer ungültigen Farbe ist der Alpha-Wert der zurückgegebenen Farbe nicht definiert.
Siehe auch setRgba(), rgb() und rgba64().
[noexcept] int QColor::saturation() const
Gibt die HSV-Sättigungskomponente dieser Farbe zurück.
Die Farbe wird implizit in HSV konvertiert.
Siehe auch hsvSaturation(), hslSaturation(), saturationF(), getHsv() und The HSV Color Model.
[noexcept] float QColor::saturationF() const
Gibt die HSV-Sättigungskomponente dieser Farbe zurück.
Die Farbe wird implizit in das HSV-Farbsystem konvertiert.
Siehe auch hsvSaturationF(), hslSaturationF(), saturation(), getHsvF() und The HSV Color Model.
void QColor::setAlpha(int alpha)
Setzt die Deckkraft dieser Farbe auf alpha. Die Deckkraft wird als Ganzzahl im Bereich von 0 bis 255 angegeben.
Siehe auch alpha(), alphaF() und Alpha-Blended Drawing.
void QColor::setAlphaF(float alpha)
Setzt die Deckkraft dieser Farbe auf alpha. Der Wert für „alpha“ wird im Bereich von 0,0 bis 1,0 angegeben.
Siehe auch alphaF(), alpha() und Alpha-Blended Drawing.
void QColor::setBlue(int blue)
Setzt die blaue Farbkomponente dieser Farbe auf „ blue “. Ganzzahlige Komponenten werden im Bereich von 0 bis 255 angegeben.
Siehe auch blue(), blueF() und setRgb().
void QColor::setBlueF(float blue)
Setzt die blaue Farbkomponente dieser Farbe auf blue. Liegt blue außerhalb des Bereichs von 0,0 bis 1,0, wird das Farbmodell auf ExtendedRgb umgestellt.
Siehe auch blueF(), blue() und setRgbF().
void QColor::setCmyk(int c, int m, int y, int k, int a = 255)
Legt die Farbe auf die CMYK-Werte „ c “ (Cyan), „ m “ (Magenta), „ y “ (Gelb), „ k “ (Schwarz) und „ a “ (Alphakanal, d. h. Transparenz) fest.
Alle Werte müssen im Bereich von 0 bis 255 liegen.
Siehe auch getCmyk(), setCmykF() und The CMYK Color Model.
void QColor::setCmykF(float c, float m, float y, float k, float a = 1.0)
Legt die Farbe anhand der CMYK-Werte fest: c (Cyan), m (Magenta), y (Gelb), k (Schwarz) und a (Alphakanal, d. h. Transparenz).
Alle Werte müssen im Bereich von 0,0 bis 1,0 liegen.
Siehe auch getCmykF(), setCmyk() und The CMYK Color Model.
void QColor::setGreen(int green)
Setzt die grüne Farbkomponente dieser Farbe auf green. Ganzzahlige Komponenten werden im Bereich von 0 bis 255 angegeben.
Siehe auch green(), greenF() und setRgb().
void QColor::setGreenF(float green)
Setzt die grüne Farbkomponente dieser Farbe auf green. Liegt green außerhalb des Bereichs von 0,0 bis 1,0, wird das Farbmodell auf ExtendedRgb umgestellt.
Siehe auch greenF(), green() und setRgbF().
void QColor::setHsl(int h, int s, int l, int a = 255)
Legt einen HSL-Farbwert fest; h ist der Farbton, s ist die Sättigung, l ist die Helligkeit und a ist die Alpha-Komponente der HSL-Farbe.
Die Werte für Sättigung, Helligkeit und Alphakanal müssen im Bereich von 0 bis 255 liegen, und der Farbtonwert muss größer als -1 sein.
Siehe auch getHsl() und setHslF().
void QColor::setHslF(float h, float s, float l, float a = 1.0)
Legt die Helligkeit einer HSL-Farbe fest; h ist der Farbton, s die Sättigung, l die Helligkeit und a die Alpha-Komponente der HSL-Farbe.
Alle Werte müssen im Bereich von 0,0 bis 1,0 liegen.
Siehe auch getHslF() und setHsl().
void QColor::setHsv(int h, int s, int v, int a = 255)
Legt einen HSV-Farbwert fest; h ist der Farbton, s ist die Sättigung, v ist die Helligkeit und a ist die Alpha-Komponente der HSV-Farbe.
Die Werte für Sättigung, Helligkeit und den Alphakanal müssen im Bereich von 0 bis 255 liegen, und der Farbtonwert muss größer als -1 sein.
Siehe auch getHsv(), setHsvF() und The HSV Color Model.
void QColor::setHsvF(float h, float s, float v, float a = 1.0)
Legt einen HSV-Farbwert fest; h ist der Farbton, s ist die Sättigung, v ist der Wert und a ist die Alpha-Komponente der HSV-Farbe.
Alle Werte müssen im Bereich von 0,0 bis 1,0 liegen.
Siehe auch getHsvF(), setHsv() und The HSV Color Model.
void QColor::setRed(int red)
Setzt die rote Farbkomponente dieser Farbe auf „ red “. Ganzzahlige Komponenten werden im Bereich von 0 bis 255 angegeben.
Siehe auch „ red()“, „ redF()“ und „ setRgb()“.
void QColor::setRedF(float red)
Setzt die rote Farbkomponente dieser Farbe auf red. Liegt red außerhalb des Bereichs von 0,0 bis 1,0, wird das Farbmodell auf ExtendedRgb geändert.
Siehe auch redF(), red() und setRgbF().
void QColor::setRgb(int r, int g, int b, int a = 255)
Setzt den RGB-Wert auf r, g, b und den Alpha-Wert auf a.
Alle Werte müssen im Bereich von 0 bis 255 liegen.
Siehe auch rgb(), getRgb() und setRgbF().
[noexcept] void QColor::setRgb(QRgb rgb)
Setzt den RGB-Wert auf rgb. Der Alpha-Wert wird auf „undurchsichtig“ gesetzt.
Dies ist eine überladene Funktion.
[noexcept] void QColor::setRgba64(QRgba64 rgba)
Setzt den RGB64-Wert auf „ rgba “, einschließlich des Alpha-Werts.
Siehe auch „ setRgba()“ und „ rgba64()“.
void QColor::setRgbF(float r, float g, float b, float a = 1.0)
Legt die Farbkanäle dieser Farbe auf r (Rot), g (Grün), b (Blau) und a (Alpha, Transparenz) fest.
Der Alpha-Wert muss im Bereich von 0,0 bis 1,0 liegen. Liegt einer der anderen Werte außerhalb des Bereichs von 0,0 bis 1,0, wird das Farbmodell auf „ ExtendedRgb “ gesetzt.
Siehe auch rgb(), getRgbF() und setRgb().
[noexcept] void QColor::setRgba(QRgb rgba)
Setzt den RGB-Wert auf rgba, einschließlich des Alpha-Werts.
Siehe auch rgba(), rgb() und setRgba64().
[noexcept] QColor::Spec QColor::spec() const
Gibt zurück, wie die Farbe angegeben wurde.
Siehe auch „ Spec “ und „ convertTo()“.
[noexcept] QColor QColor::toCmyk() const
Erzeugt und gibt einen CMYK- QColor zurück, der auf dieser Farbe basiert.
Siehe auch „ fromCmyk()“, „ convertTo()“, „ isValid()“ und „ The CMYK Color Model “.
[noexcept] QColor QColor::toExtendedRgb() const
Erstellt und gibt ein erweitertes RGB- QColor zurück, das auf dieser Farbe basiert.
Siehe auch „ toRgb “ und „ convertTo()“.
[noexcept] QColor QColor::toHsl() const
Erzeugt und gibt eine HSL- QColor zurück, die auf dieser Farbe basiert.
Siehe auch „ fromHsl()“, „ convertTo()“, „ isValid()“ und „ The HSL Color Model “.
[noexcept] QColor QColor::toHsv() const
Erstellt und gibt einen HSV- QColor zurück, der auf dieser Farbe basiert.
Siehe auch fromHsv(), convertTo(), isValid() und The HSV Color Model.
[noexcept] QColor QColor::toRgb() const
Erstellt und gibt ein RGB- QColor -Objekt basierend auf dieser Farbe zurück.
Siehe auch „ fromRgb()“, „ convertTo()“ und „ isValid()“.
[noexcept] int QColor::value() const
Gibt die Farbkomponente dieser Farbe zurück.
Siehe auch valueF(), getHsv() und The HSV Color Model.
[noexcept] float QColor::valueF() const
Gibt die Farbkomponente dieser Farbe zurück.
Siehe auch value(), getHsvF() und The HSV Color Model.
[noexcept] int QColor::yellow() const
Gibt die gelbe Farbkomponente dieser Farbe zurück.
Siehe auch yellowF(), getCmyk() und The CMYK Color Model.
[noexcept] float QColor::yellowF() const
Gibt die gelbe Farbkomponente dieser Farbe zurück.
Siehe auch yellow(), getCmykF() und The CMYK Color Model.
QColor::operator QVariant() const
Gibt die Farbe als QVariant
[noexcept] bool QColor::operator!=(const QColor &color) const
Gibt „ true “ zurück, wenn diese Farbe eine andere Farbspezifikation oder andere Komponentenwerte als „ color “ aufweist; andernfalls wird „ false “ zurückgegeben.
ExtendedRgb In diesem Zusammenhang gelten RGB-Spezifikationen als übereinstimmend.
Siehe auch spec().
[noexcept] QColor &QColor::operator=(Qt::GlobalColor color)
Weist eine Kopie von „ color “ zu und gibt einen Verweis auf diese Farbe zurück.
[noexcept] bool QColor::operator==(const QColor &color) const
Gibt „ true “ zurück, wenn diese Farbe dieselbe Farbspezifikation und dieselben Komponentenwerte wie „ color “ aufweist; andernfalls wird „ false “ zurückgegeben.
ExtendedRgb In diesem Zusammenhang gelten RGB-Spezifikationen als übereinstimmend.
Siehe auch spec().
Verwandte Nicht-Mitglieder
QRgb
Ein ARGB-Quadruplet im Format #AARRGGBB, das einem vorzeichenlosen Integer entspricht.
Der Typ enthält außerdem einen Wert für den Alphakanal. Der Standard-Alphakanal ist „ ff “, d. h. undurchsichtig. Weitere Informationen finden Sie im Abschnitt „ Alpha-Blended Drawing “.
Hier sind einige Beispiele dafür, wie QRgb-Werte erstellt werden können:
const QRgb rgb1 = 0x88112233;
const QRgb rgb2 = QColor("red").rgb();
const QRgb rgb3 = qRgb(qRed(rgb1), qGreen(rgb2), qBlue(rgb2));
const QRgb rgb4 = qRgba(qRed(rgb1), qGreen(rgb2), qBlue(rgb2), qAlpha(rgb1));Siehe auch „ qRgb()“, „ qRgba()“, „ QColor::rgb()“ und „ QColor::rgba()“.
[constexpr] int qAlpha(QRgb rgba)
Gibt die Alpha-Komponente des ARGB-Quadruplets rgba zurück.
Siehe auch qRgb() und QColor::alpha().
[constexpr] uint qAlpha(QRgba64 rgba64)
Gibt die Alpha-Komponente von rgba64 als 8-Bit-Wert zurück.
Siehe auch „ QRgba64::alpha8()“ und „ QColor::alpha()“.
[constexpr] int qBlue(QRgb rgb)
Gibt die Blaukomponente des ARGB-Quadrupletts rgb zurück.
Siehe auch qRgb() und QColor::blue().
[constexpr] uint qBlue(QRgba64 rgba64)
Gibt die Blaukomponente von rgba64 als 8-Bit-Wert zurück.
Siehe auch „ QRgba64::blue8()“ und „ QColor::blue()“.
[constexpr] int qGray(int r, int g, int b)
Gibt einen Grauwert (0 bis 255) aus dem Tripel (r, g, b) zurück.
Der Grauwert wird anhand der folgenden Formel berechnet: (r * 11 + g * 16 + b * 5)/32.
[constexpr] int qGray(QRgb rgb)
Gibt einen Grauwert (0 bis 255) aus dem angegebenen ARGB-Quadruplet „ rgb “ zurück.
Der Grauwert wird anhand der Formel (R * 11 + G * 16 + B * 5)/32 berechnet; der Alphakanal wird ignoriert.
Dies ist eine überladene Funktion.
[constexpr] int qGreen(QRgb rgb)
Gibt die Grünkomponente des ARGB-Quadruplets rgb zurück.
Siehe auch qRgb() und QColor::green().
[constexpr] uint qGreen(QRgba64 rgba64)
Gibt die Grünkomponente von rgba64 als 8-Bit-Wert zurück.
Siehe auch „ QRgba64::green8()“ und „ QColor::green()“.
[constexpr] QRgb qPremultiply(QRgb rgb)
Wandelt ein nicht vorvervielfachtes ARGB-Quadruplett rgb in ein vorvervielfachtes ARGB-Quadruplett um.
Siehe auch qUnpremultiply().
[constexpr] QRgba64 qPremultiply(QRgba64 rgba64)
Konvertiert ein nicht vorvervielfachtes QRgba64 -Quadruplett rgba64 in ein vorvervielfachtes QRgba64 -Quadruplett.
Siehe auch QRgba64::premultiplied() und qUnpremultiply().
[constexpr] int qRed(QRgb rgb)
Gibt die Rotkomponente des ARGB-Quadruplets rgb zurück.
Siehe auch qRgb() und QColor::red().
[constexpr] uint qRed(QRgba64 rgba64)
Gibt die Rotkomponente von rgba64 als 8-Bit-Wert zurück.
Siehe auch „ QRgba64::red8()“ und „ QColor::red()“.
[constexpr] QRgb qRgb(int r, int g, int b)
Gibt das ARGB-Quadruplet (255, r, g, b) zurück.
Siehe auch qRgba(), qRed(), qGreen(), qBlue() und qAlpha().
[constexpr] QRgba64 qRgba64(quint64 c)
Gibt „ c “ als Struktur vom Typ „ QRgba64 “ zurück.
Siehe auch qRgba().
[constexpr] QRgba64 qRgba64(quint16 r, quint16 g, quint16 b, quint16 a)
Gibt das Vierergespann „ QRgba64 “ zurück (r, g, b, a).
Siehe auch qRgba().
[constexpr] QRgb qRgba(int r, int g, int b, int a)
Gibt das ARGB-Quadruplett zurück (a, r, g, b).
Siehe auch qRgb(), qRed(), qGreen(), qBlue() und qAlpha().
QRgb qUnpremultiply(QRgb rgb)
Wandelt ein vorvervielfachtes ARGB-Quadruplet rgb in ein nicht vorvervielfachtes ARGB-Quadruplet um.
Siehe auch qPremultiply().
[constexpr] QRgba64 qUnpremultiply(QRgba64 rgba64)
Konvertiert ein vormultipliziertes QRgba64 -Quadruplett rgba64 in ein nicht vormultipliziertes QRgba64 -Quadruplett.
Siehe auch QRgba64::unpremultiplied() und qPremultiply().
QDataStream &operator<<(QDataStream &stream, const QColor &color)
Schreibt die „ color “ in die „ stream “.
Siehe auch „Serialisierung vonQt-Datentypen“.
QDataStream &operator>>(QDataStream &stream, QColor &color)
Liest die „ color “ aus der „ stream “.
Siehe auch „Serialisierung vonQt-Datentypen“.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.


