QColor 类

// 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);

成员函数文档

[constexpr noexcept] QColor::QColor()

使用 RGB 值 (0, 0, 0) 构建一个无效的颜色。一个无效的颜色是指未正确配置为底层窗口系统的颜色。

无效颜色的 alpha 值是不确定的。

另请参阅isValid()。

[noexcept] QColor::QColor(Qt::GlobalColor color)

这是一个重载函数。

使用 color 的颜色值构建一个新的颜色。

另请参阅isValid() 和 预定义颜色。

[constexpr noexcept] QColor::QColor(int r, int g, int b, int a = 255)

使用 r，g，b 的 RGB 值和一个 alphații（透明度）值 a 构建一个颜色。

如果任何参数无效，颜色设置为无效。

另请参阅setRgba() 和 isValid。

[noexcept] QColor::QColor(QRgb color)

使用 color 的值构建一个颜色。alpha 组件被忽略并设置为不透明。

另请参阅fromRgb() 和 isValid。

[noexcept] QColor::QColor(QRgba64 rgba64)

使用 rgba64 的值构建一个颜色。

另请参阅fromRgba64。

QColor::QColor(const QString &name)

使用提供的 name ，以与 setNamedColor() 相同的方式构建一个命名颜色。

如果 name 无法解析，颜色保留为无效。

另请参阅setNamedColor，name 和 isValid。

QColor::QColor(QLatin1StringView name)

使用提供的 name ，以与 setNamedColor() 相同的方式构建一个命名颜色。

这是一个重载函数。

另请参阅setNamedColor，name 和 isValid。

QColor::QColor(QString name)

使用提供的 name ，以与 setNamedColor() 相同的方式构建一个命名颜色。

这是一个重载函数。

另请参阅setNamedColor，name 和 isValid。

[noexcept] int QColor::alpha() const

返回此颜色的 alpha 颜色组件。

另请参阅setAlpha，alphaF 和 Alpha 合成绘制。

[noexcept] float QColor::alphaF() const

返回此颜色的 alpha 颜色组件。

另请参阅setAlphaF、alpha 和 Alpha-Blended Drawing。

[noexcept] int QColor::black() const

返回此颜色的黑色分量。

另请参阅blackF、getCmyk 和 CMYK颜色模型。

[noexcept] float QColor::blackF() const

返回此颜色的黑色分量。

另请参阅black、getCmykF 和 CMYK颜色模型。

[noexcept] int QColor::blue() const

返回此颜色的蓝色分量。

另请参阅setBlue、blueF 和 getRgb。

[noexcept] float QColor::blueF() const

返回此颜色的蓝色分量。

另请参阅setBlueF、blue 和 getRgbF。

[static] QStringList QColor::colorNames()

返回包含Qt已知的颜色名称的QStringList。

另请参阅预定义颜色。

[noexcept] QColor QColor::convertTo(QColor::Spec colorSpec) const

根据colorSpec指定的格式创建一个此颜色的副本。

另请参阅spec、toCmyk、toHsv、toRgb 和 isValid。

[noexcept] int QColor::cyan() const

返回此颜色的青色分量。

另请参阅cyanF、getCmyk 和 CMYK颜色模型。

[noexcept] float QColor::cyanF() const

返回此颜色的青色分量。

另请参阅cyan、getCmykF 和 CMYK颜色模型。

[noexcept] QColor QColor::darker(int factor = 200) const

返回一个较暗（或较亮）的颜色，但不会改变此对象。

如果factor大于100，此函数返回一个较暗的颜色。将factor设置为300将返回亮度为三分之一的颜色。如果factor小于100，返回的颜色较亮，但我们推荐使用lighter()函数进行此目的。如果factor为0或负数，返回值未指定。

此函数将当前颜色转换为HSV，将值（V）分量除以因子，并将颜色转换回原始颜色规范。

另请参阅lighter() 和 isValid()。

[静态] QColor QColor::fromCmyk(int c, int m, int y, int k, int a = 255)

静态便利函数，返回由给定的CMYK颜色值构建的QColor：c（青色），m（品红色），y（黄色），k（黑色），和a（透明通道，即透明度）。

所有值必须在0-255的范围内。

另请参阅toCmyk()，fromCmykF()，isValid()，以及CMYK颜色模型。

[静态] QColor QColor::fromCmykF(float c, float m, float y, float k, float a = 1.0)

这是一个重载函数。

静态便利函数，返回由给定的CMYK颜色值构建的QColor：c（青色），m（品红色），y（黄色），k（黑色），和a（透明通道，即透明度）。

所有值必须在0.0-1.0的范围内。

另请参阅toCmyk()，fromCmyk()，isValid()，以及CMYK颜色模型。

[静态] QColor QColor::fromHsl(int h, int s, int l, int a = 255)

静态便利函数，返回由HSV颜色值构建的QColor：h（色调），s（饱和度），l（亮度），和a（透明通道，即透明度）。

s，l和a的值必须在0-255的范围内；h的值必须在0-359的范围内。

另请参阅toHsl()，fromHslF()，isValid()，以及HSL颜色模型。

[静态] QColor QColor::fromHslF(float h, float s, float l, float a = 1.0)

这是一个重载函数。

静态便利函数，返回由HSV颜色值构建的QColor：h（色调），s（饱和度），l（亮度），和a（透明通道，即透明度）。

所有值必须在0.0-1.0的范围内。

另请参阅toHsl()，fromHsl()，isValid()，以及HSL颜色模型。

[静态] QColor QColor::fromHsv(int h, int s, int v, int a = 255)

静态便利函数，返回由HSV颜色值构建的QColor：h（色调），s（饱和度），v（值），和a（透明通道，即透明度）。

s，v和a的值都必须在0-255的范围内；h的值必须在0-359的范围内。

另请参阅 toHsv(), fromHsvF(), isValid() 以及 HSV 色彩模型.

[静态] QColor QColor::fromHsvF(float h, float s, float v, float a = 1.0)

这是一个重载函数。

静态便利函数，返回由HSV颜色值构建的QColor：h（色调），s（饱和度），v（值），和a（透明通道，即透明度）。

所有值必须在0.0-1.0的范围内。

另请参阅 toHsv(), fromHsv(), isValid() 以及 HSV 色彩模型.

[静态 noexcept] QColor QColor::fromRgb(QRgb rgb)

静态便利函数，返回由给定 QRgb 值 rgb 构成的 QColor.

rgb 的透明度成分被忽略（即自动设置为 255），使用 fromRgba() 函数包含由给定 QRgb 值指定的透明通道。

另请参阅 fromRgba(), fromRgbF(), toRgb() 以及 isValid.

[静态] QColor QColor::fromRgb(int r, int g, int b, int a = 255)

静态便利函数，返回由 RGB 色彩值（红 r、绿 g、蓝 b）和透明通道 a（即透明度）构成的 QColor.

所有值必须在0-255的范围内。

另请参阅 toRgb(), fromRgba64(), fromRgbF() 以及 isValid.

[静态 noexcept] QColor QColor::fromRgba64(ushort r, ushort g, ushort b, ushort a = USHRT_MAX)

静态便利函数，返回由 RGBA64 色彩值（红 r、绿 g、蓝 b、透明通道 a）构成的 QColor.

另请参阅 fromRgb(), fromRgbF(), toRgb() 以及 isValid.

[静态 noexcept] QColor QColor::fromRgba64(QRgba64 rgba64)

静态便利函数，返回由给定的 QRgba64 值 rgba64 构成的 QColor.

另请参阅 fromRgb(), fromRgbF(), toRgb() 以及 isValid.

[静态] QColor QColor::fromRgbF(float r, float g, float b, float a = 1.0)

静态便利函数，返回由 RGB 色彩值（红 r、绿 g、蓝 b）和透明通道 a（即透明度）构成的 QColor.

alpha值必须在0.0-1.0的范围内。如果其他任何值超出0.0-1.0的范围，则颜色模型将被设置为ExtendedRgb。

另见 fromRgb()，fromRgba64()，toRgb()和isValid()。

[static noexcept] QColor QColor::fromRgba(QRgb rgba)

静态方便函数，返回由给定的QRgb值rgba构建的QColor。

与fromRgb()函数不同，这里指定的QRgb值包括alpha通道。

另见 fromRgb()，fromRgba64()和isValid()。

[static noexcept, since 6.4] QColor QColor::fromString(QAnyStringView name)

从name中解析出RGB QColor，该name可能采用以下格式之一

• #RGB (R，G，B各为一个十六进制数字)
• #RRGGBB
• #AARRGGBB (自5.2起)
• #RRRGGGBBB
• #RRRRGGGGBBBB
• 来自万维网联盟提供的SVG颜色关键字列表中定义的颜色的名称；例如，“steelblue”或“gainsboro”。这些颜色名在所有平台上都有效。请注意，这些颜色名不与Qt::GlobalColor枚举中定义的相同，例如，“green”和Qt::green不指向相同的颜色。
• transparent - 表示颜色的不存在。

如果name无法解析，则返回无效的颜色。

此函数自Qt 6.4引入。

另见 isValidColorName。

void QColor::getCmyk(int *c, int *m, int *y, int *k, int *a = nullptr) const

将指出由c，m，y，k和a的内容设为颜色的CMYK值中的青色、品红色、黄色、黑色和alpha通道（透明度）组件。

可以通过使用cyan()，magenta()，yellow()，black()和alpha()函数分别检索这些组件。

另见 setCmyk()和CMYK颜色模型。

void QColor::getCmykF(float *c, float *m, float *y, float *k, float *a = nullptr) const

将指出由c，m，y，k和a的内容设为颜色的CMYK值中的青色、品红色、黄色、黑色和alpha通道（透明度）组件。

这些组件可以通过使用cyanF()，magentaF()，yellowF()，blackF()和alphaF()函数分别检索。

另见 setCmykF()和CMYK颜色模型。

void QColor::getHsl(int *h, int *s, int *l, int *a = nullptr) const

将指向h、s、l和a的内容设置为颜色HSL值的色调、饱和度、亮度和alpha通道（透明度）分量。

可以使用hslHue()、hslSaturation()、lightness()和alpha()函数分别检索这些分量。

另请参阅getHslF、setHsl和HSL颜色模型。

void QColor::getHslF(float *h, float *s, float *l, float *a = nullptr) const

将指向h、s、l和a的内容设置为颜色HSL值的色调、饱和度、亮度和alpha通道（透明度）分量。

可以使用hslHueF()、hslSaturationF()、lightnessF()和alphaF()函数分别检索这些分量。

另请参阅getHsl、setHslF和HSL颜色模型。

void QColor::getHsv(int *h, int *s, int *v, int *a = nullptr) const

将指向h、s、v和a的内容设置为颜色HSV值的色调、饱和度、值和alpha通道（透明度）分量。

可以使用hue()、saturation()、value()和alpha()函数分别检索这些分量。

另请参阅setHsv和HSV颜色模型。

void QColor::getHsvF(float *h, float *s, float *v, float *a = nullptr) const

将指向h、s、v和a的内容设置为颜色HSV值的色调、饱和度、值和alpha通道（透明度）分量。

可以使用hueF()、saturationF()、valueF()和alphaF()函数分别检索这些分量。

另请参阅setHsv和HSV颜色模型。

void QColor::getRgb(int *r, int *g, int *b, int *a = nullptr) const

将指向r、g、b和a的内容设置为颜色RGB值的红色、绿色、蓝色和alpha通道（透明度）分量。

可以使用red()、green()、blue()和alpha()函数分别检索这些分量。

另请参阅rgb()和setRgb()。

void QColor::getRgbF(float *r, float *g, float *b, float *a = nullptr) const

将指向r、g、b和a的内容设置为颜色RGB值的红色、绿色、蓝色和alpha通道（透明度）分量。

可以使用redF()、greenF()、blueF()和alphaF()函数分别检索这些分量。

另请参阅rgb()和setRgb()。

[noexcept] int QColor::green() const

返回此颜色的绿色颜色成分。

setGreen()，greenF() 和 getRgb()。

[noexcept] float QColor::greenF() const

返回此颜色的绿色颜色成分。

setGreenF()，green 和 getRgbF。

[noexcept] int QColor::hslHue() const

返回此颜色的 HSL 色调颜色成分。

hslHueF()，hsvHue()，getHsl() 和 HSL 颜色模型。

[noexcept] float QColor::hslHueF() const

返回此颜色的 HSL 色调颜色成分。

hslHue()，hsvHueF() 和 getHslF。

[noexcept] int QColor::hslSaturation() const

返回此颜色的 HSL 饱和度颜色成分。

hslSaturationF()，hsvSaturation()，getHsl() 和 HSL 颜色模型。

[noexcept] float QColor::hslSaturationF() const

返回此颜色的 HSL 饱和度颜色成分。

hslSaturation()，hsvSaturationF()，getHslF 和 HSL 颜色模型。

[noexcept] int QColor::hsvHue() const

返回此颜色的 HSV 色调颜色成分。

hueF()，hslHue()，getHsv() 和 HSV 颜色模型。

[noexcept] float QColor::hsvHueF() const

返回此颜色的色调颜色成分。

hue()，hslHueF()，getHsvF 和 HSV 颜色模型。

[noexcept] int QColor::hsvSaturation() const

返回此颜色的 HSV 饱和度颜色成分。

saturationFs()，hslSaturation()，getHsv() 和 HSV 颜色模型。

[noexcept] float QColor::hsvSaturationF() const

返回此颜色的 HSV 饱和度颜色成分。

saturation()，hslSaturationF()，getHsvF 和 HSV 颜色模型。

[noexcept] int QColor::hue() const

返回此颜色的 HSV 色调颜色成分。

颜色会隐式转换为HSV格式。

另请参阅 hsvHue（）， hslHue（）， hueF（）， getHsv（），以及 HSV颜色模型。

[noexcept] float QColor::hueF() const

返回此颜色的 HSV 色调颜色成分。

颜色会隐式转换为HSV格式。

另请参阅 hsvHueF（）， hslHueF（）， hue（）， getHsvF（），以及 HSV颜色模型。

[noexcept] bool QColor::isValid() const

如果颜色有效则返回 true，否则返回 false。

[静态noexcept，自6.4版本起] bool QColor::isValidColorName(QAnyStringView name)

如果 name 是有效的颜色名称并且可以用来构造一个有效的 QColor 对象，则返回 true，否则返回 false。

它使用与 fromString() 相同的算法。

此函数自Qt 6.4引入。

另请参阅 fromString。

[noexcept] QColor QColor::lighter(int factor = 150) const

返回一个更亮（或更暗）的颜色，但不会改变此对象。

如果 factor 大于 100，此函数返回更亮的颜色。将 factor 设置为 150 将返回一个亮 50% 的颜色。如果 factor 小于 100，返回的颜色会更暗，但我们推荐使用 darker 函数来实现这个目的。如果 factor 为 0 或负值，则返回值是不确定的。

该函数将当前颜色转换为HSV，将值（V）分量乘以 factor，然后将颜色转换回原始颜色规范。

另请参阅 darker（）和 isValid。

[noexcept] int QColor::lightness() const

返回此颜色的亮度颜色分量。

另请参阅 lightnessF（）和 getHsl（）。

[noexcept] float QColor::lightnessF() const

返回此颜色的亮度颜色分量。

另请参阅 value（）和 getHslF（）。

[noexcept] int QColor::magenta() const

返回此颜色的洋红色分量。

另请参阅 magentaF（）， getCmyk（），以及 CMYK颜色模型。

[noexcept] float QColor::magentaF() const

返回此颜色的洋红色分量。

另请参阅 magenta()，getCmykF() 和 CMYK颜色模型。

QString QColor::name(QColor::NameFormat format = HexRgb) const

以指定格式返回颜色的名称。

另请参阅 fromString() 和 NameFormat。

[noexcept] int QColor::red() const

返回此颜色的红色分量。

另请参阅 setRed()，redF() 和 getRgb。

[noexcept] float QColor::redF() const

返回此颜色的红色分量。

另请参阅 setRedF()，red() 和 getRgbF。

[noexcept] QRgb QColor::rgb() const

返回颜色的RGB值。alpha值是不透明的。

另请参阅 setRgb()，getRgb() 和 rgba。

[noexcept] QRgba64 QColor::rgba64() const

返回颜色的RGB64值，包括其alpha值。

对于无效的颜色，返回颜色的alpha值未指定。

另请参阅 setRgba64()，rgba() 和 rgb。

[noexcept] QRgb QColor::rgba() const

返回包括其alpha的颜色的RGB值。

对于无效的颜色，返回颜色的alpha值未指定。

另请参阅 setRgba()，rgb() 和 rgba64。

[noexcept] int QColor::saturation() const

返回此颜色的 HSV 饱和度颜色成分。

颜色会隐式转换为HSV格式。

另请参阅 hsvSaturation()，hslSaturation，saturationF，getHsv() 和 HSV颜色模型。

[noexcept] float QColor::saturationF() const

返回此颜色的 HSV 饱和度颜色成分。

颜色会隐式转换为HSV格式。

另请参阅 hsvSaturationF，hslSaturationF，saturation，getHsvF() 和 HSV颜色模型。

void QColor::setAlpha(int alpha)

将此颜色的alpha设为alpha。整数alpha的范围是0-255。

另请参阅 alpha，alphaF 和 透明混合绘制。

void QColor::setAlphaF(float alpha)

将此颜色的alpha设置为alpha。浮点alpha的范围是0.0-1.0。

另请参阅 alphaF()，alpha() 和 Alpha-Blended Drawing。

void QColor::setBlue(int blue)

设置此颜色的蓝色分量。整数分量指定在 0-255 的范围内。

另请参阅 blue()，blueF() 和 setRgb()。

void QColor::setBlueF(float blue)

将此颜色的蓝色分量设置为 blue。如果 blue 超出 0.0-1.0 的范围，颜色模型将更改为 ExtendedRgb。

另请参阅 blueF()，blue() 和 setRgbF()。

void QColor::setCmyk(int c, int m, int y, int k, int a = 255)

将颜色设置为 CMYK 值，c（青色），m（品红色），y（黄色），k（黑色），和 a（透明度，即 alpha 通道）。

所有值必须在0-255的范围内。

另请参阅 getCmyk()，setCmykF() 和 CMYK 颜色模型。

void QColor::setCmykF(float c, float m, float y, float k, float a = 1.0)

这是一个重载函数。

将颜色设置为 CMYK 值，c（青色），m（品红色），y（黄色），k（黑色），和 a（透明度，即 alpha 通道）。

所有值必须在0.0-1.0的范围内。

另请参阅 getCmykF()，setCmyk() 和 CMYK 颜色模型。

void QColor::setGreen(int green)

设置此颜色的绿色分量。整数分量指定在 0-255 的范围内。

另请参阅 green()，greenF() 和 setRgb()。

void QColor::setGreenF(float green)

将此颜色的绿色分量设置为 green。如果 green 超出 0.0-1.0 的范围，颜色模型将更改为 ExtendedRgb。

另请参阅 greenF()，green() 和 setRgbF()。

void QColor::setHsl(int h, int s, int l, int a = 255)

设置 HSL 颜色值；h 是色调，s 是饱和度，l 是亮度，而 a 是 HSL 颜色的 alpha 分量。

饱和度、亮度和 alpha 通道值必须在 0-255 的范围内，而色调值必须大于 -1。

另请参阅 getHsl() 和 setHslF()。

void QColor::setHslF(float h, float s, float l, float a = 1.0)

设置 HSL 颜色的亮度；h 是色调，s 是饱和度，l 是亮度，而 a 是 HSL 颜色的 alpha 分量。

所有值必须在0.0-1.0的范围内。

另请参阅 getHslF() 和 setHsl().

void QColor::setHsv(int h, int s, int v, int a = 255)

设置HSV颜色值；h 为色调，s 为饱和度，v 为亮度，和 a 为HSV颜色的alpha成分。

饱和度、亮度和 alpha 通道值必须在 0-255 的范围内，而色调值必须大于 -1。

另请参阅 getHsv()，setHsvF()，和 HSV颜色模型.

void QColor::setHsvF(float h, float s, float v, float a = 1.0)

设置HSV颜色值；h 为色调，s 为饱和度，v 为亮度，和 a 为HSV颜色的alpha成分。

所有值必须在0.0-1.0的范围内。

另请参阅 getHsvF()，setHsv，和 HSV颜色模型.

void QColor::setRed(int red)

将此颜色的红色成分设为 red。整数成分在0-255范围内指定。

另请参阅 red()，redF，和 setRgb().

void QColor::setRedF(float red)

将此颜色的红色成分设为 red。如果 red 超出0.0-1.0范围，颜色模型将改为 ExtendedRgb。

另请参阅 redF()，red，和 setRgbF().

void QColor::setRgb(int r, int g, int b, int a = 255)

将RGB值设置为 r、g、b，并设置alpha值为 a。

所有值必须在0-255的范围内。

另请参阅 rgb()，getRgb，和 setRgbF().

[noexcept] void QColor::setRgb(QRgb rgb)

这是一个重载函数。

将RGB值设置为 rgb。alpha值设置为不透明。

[noexcept] void QColor::setRgba64(QRgba64 rgba)

将RGB64值设置为 rgba，包括其alpha值。

另请参阅 setRgba() 和 rgba64().

void QColor::setRgbF(float r, float g, float b, float a = 1.0)

将此颜色的通道设置为 r（红色）、g（绿色）、b（蓝色），和 a（alpha，透明度）。

alpha值必须在0.0-1.0的范围内。如果其他任何值超出0.0-1.0的范围，则颜色模型将被设置为ExtendedRgb。

另请参阅 rgb()，getRgbF，和 setRgb().

[noexcept] void QColor::setRgba(QRgb rgba)

设置RGB值到rgba，包括其alpha值。

另请参阅rgba()，rgb()，和setRgba64()。

[noexcept] QColor::Spec QColor::spec() const

返回颜色是如何指定的。

另请参阅Spec和convertTo()。

[noexcept] QColor QColor::toCmyk() const

创建并返回基于此颜色的CMYK QColor。

另请参阅fromCmyk()，convertTo()，isValid()，和CMYK颜色模型。

[noexcept] QColor QColor::toExtendedRgb() const

基于此颜色创建并返回一个扩展的RGB QColor。

另请参阅toRgb和convertTo。

[noexcept] QColor QColor::toHsl() const

创建并返回基于此颜色的HSL QColor。

另请参阅fromHsl()，convertTo()，isValid()，和HSL颜色模型。

[noexcept] QColor QColor::toHsv() const

创建并返回基于此颜色的HSV QColor。

另请参阅fromHsv()，convertTo()，isValid()，和HSV颜色模型。

[noexcept] QColor QColor::toRgb() const

创建并返回基于此颜色的RGB QColor。

另请参阅fromRgb()，convertTo()，和isValid()。

[noexcept] int QColor::value() const

返回此颜色的值颜色组件。

另请参阅valueF()，getHsv()，和HSV颜色模型。

[noexcept] float QColor::valueF() const

返回此颜色的值颜色组件。

另请参阅value()，getHsvF()，和HSV颜色模型。

[noexcept] int QColor::yellow() const

返回此颜色的黄色颜色组件。

另请参阅 yellowF()，getCmyk()，以及 CMYK颜色模型。

[noexcept] float QColor::yellowF() const

返回此颜色的黄色颜色组件。

另请参阅 yellow，getCmykF，以及 CMYK颜色模型。

QVariant QColor::operator QVariant() const

以 QVariant 形式返回颜色。

[noexcept] bool QColor::operator!=(const QColor &color) const

如果此颜色与 color 的颜色规范或组件值不同，则返回 true；否则返回 false。

在此上下文中，考虑 ExtendedRgb 和 Rgb 规范是匹配的。

另请参阅 spec。

[noexcept] QColor &QColor::operator=(Qt::GlobalColor color)

这是一个重载函数。

分配一个 color 的副本，并返回对此颜色的引用。

[noexcept] bool QColor::operator==(const QColor &color) const

如果此颜色与 color 的颜色规范和组件值相同，则返回 true；否则返回 false。

在此上下文中，考虑 ExtendedRgb 和 Rgb 规范是匹配的。

另请参阅 spec。

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));