类 QColor#

QColor 类提供了基于 RGB、HSV 或 CMYK 值的颜色。 更多...

摘要#

方法#

静态函数

注意：

本文档可能包含自动从C++翻译到Python的片段。我们始终欢迎对片段翻译的贡献。如果您发现翻译有问题，也可以通过在https:/bugreports.qt.io/projects/PYSIDE创建工单来知会我们。

详细描述#

警告：

本节包含自动从C++翻译到Python的片段，可能包含错误。

颜色通常以RGB（红色、绿色和蓝色）组件来指定，但也可能使用HSV（色调、饱和度和亮度）和CMYK（青、品红、黄和黑）组件来指定。此外，颜色可以使用颜色名称来指定。颜色名称可以是SVG 1.0的颜色名称中的任何一个。

RGB：

HSV：

CMYK：

qcolor-rgb1

qcolor-hsv2

qcolor-cmyk3

QColor 构造函数通过 RGB 值创建颜色。要使用 HSV 或 CMYK 值创建基于 QColor，请分别使用 toHsv() 和 toCmyk() 函数。这些函数返回使用所需格式的颜色的副本。此外，静态函数 fromRgb()、fromHsv() 和 fromCmyk() 可以根据指定的值创建颜色。或者，可以使用 convertTo() 函数（返回所需格式的颜色副本），或使用任何一个 setRgb()、setHsv() 和 setCmyk() 函数更改此颜色格式。该 spec() 函数说明颜色是如何指定的。

可以通过传递 RGB 字符串（例如 "112233"）、ARGB 字符串（例如 "ff112233"）或颜色名称（例如 "blue"）到 fromString() 函数来设置颜色。颜色名称来自 SVG 1.0 颜色名称。该 name() 函数返回颜色的格式 "##RRGGBB"。也可以使用 setRgb()、setHsv() 和 setCmyk() 来设置颜色。要获得更亮或更暗的颜色，请分别使用 lighter() 和 darker() 函数。

isValid() 函数用于判断 QColor 对象是否合法。例如，RGB值的范围之外的RGB颜色是不合法的。出于性能考虑，QColor 主要忽略了非法颜色，因此使用无效颜色的结果是未定义的。

可以通过如 red()、hue() 以及 cyan() 等函数单独获取颜色分量。也可以使用 getRgb()、getHsv() 和 getCmyk() 函数一次性获取颜色分量的值。使用RGB颜色模型，可以通过 rgb() 函数访问颜色分量。

存在几个相关的非成员函数：QRgb 是一个表示RGB值三元组的无符号整数的typedef。注意，它还可以存储alpha通道的值（了解更多信息，请参阅 Alpha-Blended Drawing 部分）。函数 qRed()、qBlue() 和 qGreen() 返回给定 QRgb 值的相应分量，而函数 qRgb() 和 qRgba() 基于给定分量值创建并返回 QRgb 三元组。最后，函数 qAlpha() 返回提供的 QRgb 的alpha分量，而函数 qGray() 根据给定值计算并返回一个灰度值。

QColor 对象是平台和设备无关的。QColormap类将颜色映射到硬件上。

有关绘画的更详细信息，请参阅绘制系统文档。

整数与浮点精度对比#

QColor 支持浮点精度并提供所有颜色分量函数的浮点版本，例如 getRgbF() ， hueF() 和 fromCmykF() 。注意，由于分量是使用16位整数存储的，因此可能存在由于舍入而产生的微小的偏差，这可能会在例如使用 setRgbF() 设置的值和使用 getRgbF() 函数返回的值之间产生较小偏差。

虽然基于整数的函数在0-255（除了必须具有0-359范围内的值的 hue() ）范围内取值，但浮点函数接受0.0 - 1.0范围内的值。

Alpha混合绘制#

QColor 也支持alpha混合填充和轮廓。颜色的alpha通道指定透明效果，0表示完全透明，而255表示完全不透明。例如

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

上面的代码产生以下输出

../../_images/alphafill.png

可以使用 alpha() 和 setAlpha() 函数检索和设置颜色的alpha通道，如果它的值是整数，或者如果是浮点数，则使用 alphaF() 和 setAlphaF()。默认情况下，alpha通道设置为255（不透明）。要一次检索和设置 所有 RGB颜色分量（包括alpha通道），请使用 rgba() 和 setRgba() 函数。

预定义颜色#

在 QColorConstants 命名空间中存在20个预定义的 QColor 对象，包括黑色、白色、主色和辅助颜色，这些颜色的更暗版本以及三种灰度。此外，QColorConstants::Svg 命名空间还定义了标准 SVG颜色关键字名称 的 QColor 对象。

../../_images/qt-colors.png

《QColorConstants::Color0》、《QColorConstants::Color1》和《QColorConstants::Transparent》颜色用于特殊目的。

《QColorConstants::Color0》（零像素值）和《QColorConstants::Color1》（非零像素值）是QBitmap绘制中的特殊颜色。使用《QColorConstants::Color0》绘制设置位图位为0（透明，即背景），使用《QColorConstants::Color1》绘制设置位为1（不透明，即前景）。

《QColorConstants::Transparent》用于表示透明像素。使用此值绘图时，将使用适用于下层像素格式的适当像素值。

出于历史原因，20种预定义颜色也存在于Qt::GlobalColor枚举中。

最后，QColor识别多种颜色名称（作为字符串）；静态colorNames()函数返回QColor知道的QStringList颜色名称。

扩展RGB颜色模型

扩展RGB颜色模型，也称为scRGB颜色空间，与RGB颜色模型相同，但是它允许值小于0.0和大于1.0。这使得可以表示RGB颜色空间之外的颜色的同时，仍然可以使用相同的值表示RGB颜色空间内的颜色。

HSV颜色模型

RGB模型是面向硬件的。它的表示接近大多数显示器所显示的内容。相比之下，HSV以更适合人类对颜色感知的方式表示颜色。例如，“比...更强”、“比...更暗”和“与...相反”的关系在HSV中很容易表达，但在RGB中则很难表达。

HSV，像RGB一样，有三种分量

  • H，对于色调，如果颜色是彩色的（不是灰色），则其在0到359的范围内，如果是灰色，则没有意义。它代表大多数人熟悉颜色轮上的度数。红色是0（度数），绿色是120，蓝色是240。

    qcolor-hue4

  • S，对于饱和度，在0到255的范围内，它越大，颜色就越强。灰色色调的饱和度接近0；非常强的颜色饱和度接近255。

    qcolor-saturation5

  • V，对于亮度，在0到255的范围内，它代表颜色的亮度或亮度。0是黑色；255是离黑色尽可能远。

    qcolor-value6

以下是几个例子：纯红色是H=0，S=255，V=255；一种向洋红色略为偏移的暗红色可以是H=350（相当于-10），S=255，V=180；一种灰色色调的浅红色可以有H约0（比如说350-359或0-10），S约50-100，V=255。

Qt为无彩色颜色返回-1的色调值。如果您传入一个过大的色调值，Qt将其强制入范围。色调360或720被视为0；色调540被视为180。

除了标准的HSV模型之外，Qt还提供了alpha通道，以实现alpha-blended drawing功能。

HSL颜色模型

HSL与HSV类似，但与值参数不同，HSL指定了一个亮度参数，它以某种方式映射到颜色的亮度。

类似地，相同颜色的HSL饱和值通常不等于HSV饱和值。 hslSaturation() 提供颜色的HSL饱和值，而 saturation() 和 hsvSaturation() 提供的是HSV饱和值。

色调值在HSL和HSV中定义为相同。

CMYK颜色模型#

虽然RGB和HSV颜色模型用于计算机显示器的显示，但CMYK模型用于印刷机四色印刷过程和一些硬拷贝设备。

CMYK有四个组件，范围在0-255：青色（C）、品红色（M）、黄色（Y）和黑色（K）。青色、品红色和黄色被称为减色；CMYK颜色模型通过从白色表面开始并应用适当的组分来减去颜色来创建颜色。虽然混合青色、品红色和黄色可以得到黑色，但减去一个或多个可以得到任何其他颜色。当以不同百分比组合时，这三种颜色可以产生整个颜色光谱。

混合100%的青色、品红色和黄色 确实 产生黑色，但结果不佳，因为它浪费油墨，增加干燥时间，并在打印时产生泥泞的颜色。因此，在专业印刷中添加黑色以提供坚实的黑色色调；因此术语“四色过程”。

除了标准的CMYK模型外，Qt还提供了一个透明度通道，以实现 alpha-blended drawing 的功能。

class Spec#

指定的颜色类型，RGB、扩展RGB、HSV、CMYK或HSL。

常量

描述

QColor.Rgb

QColor.Hsv

QColor.Cmyk

QColor.Hsl

QColor.ExtendedRgb

QColor.Invalid

另请参阅

spec() convertTo()

class NameFormat#

如何格式化 name() 函数的输出

常量

描述

QColor.HexRgb

#RRGGBB 以“#”字符开头，后面跟着三个二进制十六进制数（即 #RRGGBB）。

QColor.HexArgb

#AARRGGBB 以“#”字符开头，后面跟着四个二进制十六进制数（即 #AARRGGBB）。

另请参阅

name()

__init__(spec, a1, a2, a3, a4[, a5=0])#
参数：

  • spec – Spec

  • a1 – int

  • a2 – int

  • a3 – int

  • a4 – int

  • a5 – int

__init__()

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

无效颜色的alpha值未指定。

另请参阅

isValid()

__init__(rgb)
参数：

rgb – int

__init__(r, g, b[, a=255])
参数：

  • r – int

  • g – int

  • b – int

  • a – int

使用RGB值 r、g、b 和alpha通道（透明度）值 a 构造一个颜色。

如果任何参数无效，则颜色将保持无效。

另请参阅

setRgba() isValid()

__init__(name)
参数：

name – str

使用给定的 name 的方式，如同 setNamedColor() 函数一样，构造一个命名的颜色。

如果无法解析 name，则颜色将保持无效。

__init__(color)
参数：

color – GlobalColor

这是一个重载函数。

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

另请参阅

isValid() 预定义 颜色

__init__(name)
参数：

name – str

__init__(arg__1)
参数：

arg__1 – 对象

__init__(name)
参数：

name – QLatin1String

__init__(rgba64)
参数：

rgba64 – QRgba64

使用值 rgba64 构造一个颜色。

另请参阅

fromRgba64()

__reduce__()#
返回类型：

对象

__repr__()#
返回类型：

对象

__setstate__(arg__1)#
参数：

arg__1 – 对象

返回类型：

对象

__str__()#
返回类型：

对象

alpha()#
返回类型：

int

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

另请参阅

setAlpha() alphaF() alpha blending drawing

alphaF()#
返回类型：

float

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

另请参阅

setAlphaF() alpha() alpha blending drawing

black()#
返回类型：

int

返回此颜色的黑色组件。

另请参阅

blackF() getCmyk() CMYK 颜色模型

blackF()#
返回类型：

float

返回此颜色的黑色组件。

另请参阅

black()getCmykF()CMYK 颜色 模型

blue() #
返回类型：

int

返回该颜色的蓝色成分。

blueF()#
返回类型：

float

返回该颜色的蓝色成分。

静态colorNames()#
返回类型：

字符串列表

返回一个包含Qt所知的颜色名称的QStringList。

另请参阅

预定义 颜色

convertTo(colorSpec)#
参数：

colorSpec - Spec

返回类型：

QColor

创建一个颜色副本，格式为 colorSpec 指定。

cyan()#
返回类型：

int

返回该颜色的青色成分。

另请参阅

cyanF()getCmyk()CMYK 颜色 模型

cyanF()#
返回类型：

float

返回该颜色的青色成分。

另请参阅

cyan() getCmykF() 色值 CMYK 模式

darker([f=200])#
参数：

f – int

返回类型：

QColor

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

如果因素值大于100，此函数返回一个较暗的颜色。将因素设置为300将返回亮度三分之一的颜色。如果因素值小于100，返回的颜色会更亮，但我们建议为此目的使用lighter函数。如果因素值为0或负值，返回值将不确定。

此函数将当前颜色转换为HSV，将值（V）组件除以factor，并将颜色转换回其原始颜色规范。

另请参阅

lighter isValid

静态fromCmyk(c, m, y, k[, a=255])#
参数：

  • c – int

  • m – int

  • y – int

  • k – int

  • a – int

返回类型：

QColor

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

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

另请参阅

toCmyk fromCmykF isValid CMYK 色值 模型

static fromCmykF(c, m, y, k[, a=1.0])#
参数：

  • c – float

  • m – float

  • y – float

  • k – float

  • a – float

返回类型：

QColor

这是一个重载函数。

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

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

另请参阅

toCmyk() fromCmyk() isValid() CMYK 颜色 模型

static fromHsl(h, s, l[, a=255])#
参数：

  • h – int

  • s – int

  • l – int

  • a – int

返回类型：

QColor

这是静态便利函数，它返回使用 HSV 颜色值、色调 (h) (色调)，饱和度 (s)，亮度 (l) 和透明度 (a) 构造的 QColor。

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

另请参阅

toHsl() fromHslF() isValid() HSL 颜色 模型

static fromHslF(h, s, l[, a=1.0])#
参数：

  • h – float

  • s – float

  • l – float

  • a – float

返回类型：

QColor

这是一个重载函数。

这是静态便利函数，它返回使用 HSV 颜色值、色调 (h) (色调)，饱和度 (s)，亮度 (l) 和透明度 (a) 构造的 QColor。

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

另请参阅

toHsl() fromHsl() isValid() 《HSL 颜色模型》

静态fromHsv(h, s, v[, a=255])#
参数：

  • h – int

  • s – int

  • h - int

  • a – int

返回类型：

QColor

静态便捷函数，返回由 HSV 颜色值（色调 h、饱和度 s、亮度 v 和可选的透明度 a）构建的 QColor 对象。

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

另请参阅

toHsv() fromHsvF() isValid() 《HSV 颜色模型》

静态fromHsvF(h, s, v[, a=1.0])#
参数：

  • h – float

  • s – float

  • h - float

  • a – float

返回类型：

QColor

这是一个重载函数。

静态便捷函数，返回由 HSV 颜色值（色调 h、饱和度 s、亮度 v 和可选的透明度 a）构建的 QColor 对象。

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

另请参阅

toHsv() fromHsv() isValid() 《HSV 颜色模型》

静态fromRgb(r, g, b[, a=255])#
参数：

  • r – int

  • g – int

  • b – int

  • a – int

返回类型：

QColor

返回由RGB颜色值（红色r，绿色g，蓝色b和透明度通道a）构造的QColor静态便捷函数。

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

static fromRgb(rgb)
参数：

rgb – int

返回类型：

QColor

从给定的QRgb值rgb构造QColor的静态便捷函数。

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

static fromRgbF(r, g, b[, a=1.0])
参数：

  • r – 浮点数

  • g – 浮点数

  • b – 浮点数

  • a – float

返回类型：

QColor

返回由RGB颜色值（红色r，绿色g，蓝色b和透明度通道a）构造的QColor静态便捷函数。

透明度值必须在0.0-1.0范围内。如果其他任何值超出0.0-1.0的范围，颜色模式将设置为ExtendedRgb。

static fromRgba(rgba)
参数：

rgba – int

返回类型：

QColor

静态便捷函数，它返回一个由指定的 QRgb 值 rgba 构建的 QColor。

与 fromRgb() 函数不同，该函数将包含通过指定的 QRgb 值指定的透明度通道。

另请参阅

fromRgb() fromRgba64() isValid()

static fromRgba64(rgba)
参数：

rgba – QRgba64

返回类型：

QColor

静态便捷函数，它返回一个由指定的 QRgba64 值 rgba64 构建的 QColor。

另请参阅

fromRgb() fromRgbF() toRgb() isValid()

static fromRgba64(r, g, b[, a=USHRT_MAX])
参数：

  • r – int

  • g – int

  • b – int

  • a – int

返回类型：

QColor

静态便捷函数，它返回一个由 RGBA64 颜色值构建的 QColor，包括红 r，绿 g，蓝 b，和透明度通道 a（即透明度）。

另请参阅

fromRgb() fromRgbF() toRgb() isValid()

static fromString(name)
参数：

name – str

返回类型：

QColor

返回从name解析出的RGB QColor，格式可能是以下之一：

  • #RGB（R、G和B每个都是单个十六进制数字）

  • #RRGGBB

  • #AARRGGBB（自5.2版起）

  • #RRRGGGBBB

  • #RRRRGGGGBBBB

  • 来自万维网联盟（W3C）提供的SVG颜色关键字名列表中的颜色名，例如，“steelblue”或“gainsboro”。这些颜色名适用于所有平台。请注意，这些颜色名与Qt::GlobalColor枚举中定义的不相同，例如，“green”和Qt::green不一定指同一颜色。

  • 透明度 - 代表没有颜色。

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

另请参阅

isValidColorName()

getCmyk()#
返回类型：

PyObject*

将c、m、y、k和a所指向的内容设置为颜色的CMYK值中的青色、品红色、黄色、黑色和alpha通道（透明度）成分。

可以使用cyan()、magenta()、yellow()、black()和alpha()函数单独检索这些成分。

另请参阅

setCmyk() The CMYK Color Model

getCmykF()#
返回类型：

PyObject*

将c、m、y、k和a所指向的内容设置为颜色的CMYK值中的青色、品红色、黄色、黑色和alpha通道（透明度）成分。

可以使用cyanF()、magentaF()、yellowF()、blackF()和alphaF()函数单独检索这些成分。

另请参阅

setCmykF() CMYK 色彩模型

getHsl()#
返回类型：

PyObject*

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

这些分量可以通过hslHue()、hslSaturation()、lightness()和alpha()函数单独检索。

另请参阅

getHslF() setHsl() HSL色彩模型

getHslF()#
返回类型：

PyObject*

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

这些分量可以通过hslHueF()、hslSaturationF()、lightnessF()和alphaF()函数单独检索。

另请参阅

getHsl() setHslF() HSL色彩模型

getHsv()#
返回类型：

PyObject*

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

这些组件可以使用 hue() ， saturation() ， value() 和 alpha() 函数单独检索。

另请参阅

setHsv() HSV 颜色 模型

getHsvF()#
返回类型：

PyObject*

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

这些组件可以使用 hueF() ， saturationF() ， valueF() 和 alphaF() 函数单独检索。

另请参阅

setHsv() HSV 颜色 模型

getRgb()#
返回类型：

PyObject*

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

这些组件可以使用 red() ， green() ， blue() 和 alpha() 函数单独检索。

另请参阅

rgb() setRgb()

getRgbF()#
返回类型：

PyObject*

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

这些组件可以使用 redF() ， greenF() ， blueF() 和 alphaF() 函数单独检索。

另请参阅

rgb() setRgb()

green()#
返回类型：

int

返回此颜色的绿色成分。

另请参阅

返回类型：

float

返回此颜色的绿色成分。

另请参阅

返回类型：

int

返回此颜色的HSL色相颜色组分。

另请参阅

返回类型：

float

返回此颜色的HSL色相颜色组分。

另请参阅

返回类型：

int

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

另请参阅

返回类型：

float

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

另请参阅

hsvHue()#
返回类型：

int

返回该颜色的HSV色调颜色组件。

另请参阅

hueF() hslHue() getHsv() HSV颜色模型

hsvHueF()#
返回类型：

float

返回该颜色的色调组件。

另请参阅

hue() hslHueF() getHsvF() HSV颜色模型

hsvSaturation()#
返回类型：

int

返回该颜色的HSV饱和度颜色组件。

另请参阅

saturationF() hslSaturation() getHsv() HSV颜色模型

hsvSaturationF()#
返回类型：

float

返回该颜色的HSV饱和度颜色组件。

另请参阅

saturation() hslSaturationF() getHsvF() HSV颜色模型

hue()#
返回类型：

int

返回该颜色的HSV色调颜色组件。

该颜色被隐式转换为HSV。

另请参阅

hsvHue() hslHue() hueF() getHsv() HSV 颜色 模型

hueF()#
返回类型：

float

返回该颜色的HSV色调颜色组件。

该颜色被隐式转换为HSV。

另请参阅

hsvHueF() hslHueF() hue() getHsvF() HSV 颜色 模型

isValid()#
返回类型：

布尔型

如果颜色有效则返回_true_，否则返回_false_。

静态isValidColor(arg__1)#
参数：

arg__1 – QLatin1String

返回类型：

布尔型

注意：

此函数已被弃用。

静态isValidColor(arg__1)
参数：

arg__1 – 字符串

返回类型：

布尔型

注意：

此函数已被弃用。

这是一个重载函数。

请使用 isValidColorName() 替代。

静态isValidColor(name)
参数：

name – str

返回类型：

布尔型

注意：

此函数已被弃用。

请使用 isValidColorName() 替代。

如果_name_是一个有效的颜色名称并且可以用来构造有效的_QColor_对象，则返回_true_，否则返回_false_。

它使用了与_setNamedColor()_相同的算法。

另请参阅

setNamedColor()

静态isValidColorName(arg__1)#
参数：

arg__1 – 字符串

返回类型：

布尔型

如果_name_是一个有效的颜色名称并且可以用来构造有效的_QColor_对象，则返回_true_，否则返回_false_。

它使用了与_fromString()_相同的算法。

另请参阅

fromString()

lighter([f=150])#
参数：

f – int

返回类型：

QColor

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

如果 factor 大于 100，则此函数返回一个更亮的颜色。将 factor 设置为 150 会得到一个亮度提升了 50% 的颜色。如果 factor 小于 100，则返回的颜色更暗，但建议使用 darker() 函数来实现此目的。如果 factor 为 0 或负数，则返回值未指定。

该函数将当前颜色转换为 HSV，将值（V）分量乘以 factor 并将颜色转换回原来的颜色规格。

另请参阅

darker() isValid()

lightness()#
返回类型：

int

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

另请参阅

lightnessF() getHsl()

lightnessF()#
返回类型：

float

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

另请参阅

value() getHslF()

magenta()#
返回类型：

int

返回此颜色的 purple 成分。

另请参阅

magentaF() getCmyk() CMYK 颜色模型

magentaF()#
返回类型：

float

返回此颜色的 purple 成分。

另请参阅

magenta() getCmykF() CMYK 颜色模型

name([format=QColor.NameFormat.HexRgb])#
参数：

格式 – NameFormat

返回类型：

str

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

另请参阅

fromString() NameFormat

__ne__(c)#
参数：

c – QColor

返回类型：

布尔型

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

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

另请参阅

spec()

__eq__(c)#
参数：

c – QColor

返回类型：

布尔型

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

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

另请参阅

spec()

red()#
返回类型：

int

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

另请参阅

setRed() redF() getRgb()

redF()#
返回类型：

float

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

另请参阅

setRedF() red() getRgbF()

rgb()#
返回类型：

int

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

另请参阅

setRgb() getRgb() rgba()

rgba()#
返回类型：

int

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

对于无效的颜色，返回颜色的 alpha 值是不确定的。

另请参阅

setRgba() rgb() rgba64()

rgba64()#
返回类型：

QRgba64

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

对于无效的颜色，返回颜色的 alpha 值是不确定的。

另请参阅

setRgba64() rgba() rgb()

saturation()#
返回类型：

int

返回该颜色的HSV饱和度颜色组件。

该颜色被隐式转换为HSV。

另请参阅

hsvSaturation() hslSaturation() saturationF() getHsv() HSV 颜色 模型

saturationF()#
返回类型：

float

返回该颜色的HSV饱和度颜色组件。

该颜色被隐式转换为HSV。

另请参阅

hsvSaturationF() hslSaturationF() saturation() getHsvF() HSV 颜色 模型

setAlpha(alpha)#
参数：

alpha – int

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

另请参阅

alpha() alphaF() Alpha-Blended Drawing

setAlphaF(alpha)#
参数：

alpha – float

将颜色的alpha值设置为 alpha。float类型的alpha值范围在0.0-1.0之间。

另请参阅

alphaF() alpha() 混合绘制

setBlue(blue)#
参数：

blue – int

将颜色的蓝色分量设置为 blue。整数分量范围在0-255之间。

另请参阅

blue() blueF() setRgb()

setBlueF(blue)#
参数：

blue – float

将颜色的蓝色分量设置为 blue。如果blue在0.0-1.0之外，颜色模型将变为ExtendedRgb。

另请参阅

blueF() blue() setRgbF()

setCmyk(c, m, y, k[, a=255])#
参数：

  • c – int

  • m – int

  • y – int

  • k – int

  • a – int

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

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

另请参阅

getCmyk() setCmykF() CMYK颜色模型

setCmykF(c, m, y, k[, a=1.0])#
参数：

  • c – float

  • m – float

  • y – float

  • k – float

  • a – float

这是一个重载函数。

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

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

另请参阅

getCmykF() setCmyk() CMYK 颜色模型

setGreen(green)#
参数：

green – int

将此颜色的绿色组件设置为 green。整数组件的范围是0-255。

另请参阅

green() greenF() setRgb()

setGreenF(green)#
参数：

green – float

将此颜色的绿色组件设置为 green。如果 green 超出了0.0-1.0的范围，颜色模型将变为 ExtendedRgb。

另请参阅

greenF() green() setRgbF()

setHsl(h, s, l[, a=255])#
参数：

  • h – int

  • s – int

  • l – int

  • a – int

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

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

另请参阅

getHsl() setHslF()

setHslF(h, s, l[, a=1.0])#
参数：

  • h – float

  • s – float

  • l – float

  • a – float

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

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

另请参阅

getHslF() setHsl()

setHsv(h, s, v[, a=255])#
参数：

  • h – int

  • s – int

  • h - int

  • a – int

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

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

另请参阅

getHsv() setHsvF() HSV颜色模型

setHsvF(h, s, v[, a=1.0])#
参数：

  • h – float

  • s – float

  • h - float

  • a – float

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

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

另请参阅

getHsvF() setHsv() HSV颜色模型

setNamedColor(name)#
参数：

name – QLatin1String

注意：

此函数已被弃用。

setNamedColor(name)
参数：

name – str

注意：

此函数已被弃用。

这是一个重载函数。

使用 fromString() 替代。

setNamedColor(name)
参数：

name – str

注意：

此函数已被弃用。

使用 fromString() 替代。

将此 QColor 的RGB值设置为 name，该名称可以是以下任何格式

  • #RGB（R、G和B每个都是单个十六进制数字）

  • #RRGGBB

  • #AARRGGBB（自5.2版起）

  • #RRRGGGBBB

  • #RRRRGGGGBBBB

  • 来自万维网联盟（W3C）提供的SVG颜色关键字名列表中的颜色名，例如，“steelblue”或“gainsboro”。这些颜色名适用于所有平台。请注意，这些颜色名与Qt::GlobalColor枚举中定义的不相同，例如，“green”和Qt::green不一定指同一颜色。

  • 透明度 - 代表没有颜色。

如果 name 无效，则此颜色无效。

另请参阅

QColor() name() isValid()

setRed(red)#
参数：

red – int

将此颜色的红色成分设置为 red。整数颜色分量为0-255范围内的值。

另请参阅

red() redF() setRgb()

setRedF(red)#
参数：

red – float

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

另请参阅

redF() red() setRgbF()

setRgb(r, g, b[, a=255])#
参数：

  • r – int

  • g – int

  • b – int

  • a – int

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

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

另请参阅

rgb() getRgb() setRgbF()

setRgb(rgb)
参数：

rgb – int

这是一个重载函数。

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

setRgbF(r, g, b[, a=1.0])#
参数：

  • r – 浮点数

  • g – 浮点数

  • b – 浮点数

  • a – float

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

透明度值必须在0.0-1.0范围内。如果其他任何值超出0.0-1.0的范围，颜色模式将设置为ExtendedRgb。

另请参阅

rgb() getRgbF() setRgb()

setRgba(rgba)#
参数：

rgba – int

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

另请参阅

rgba() rgb() setRgba64()

setRgba64(rgba)#
参数：

rgba – QRgba64

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

另请参阅

setRgba() rgba64()

spec()#
返回类型：

Spec

返回如何指定颜色。

另请参阅

Spec convertTo()

toCmyk()#
返回类型：

QColor

根据此颜色创建并返回一个 CMYK QColor。

另请参阅

fromCmyk() convertTo() isValid() The CMYK Color Model

toExtendedRgb()#
返回类型：

QColor

根据此颜色创建并返回一个扩展 RGB QColor。

另请参阅

toRgb convertTo()

toHsl()#
返回类型：

QColor

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

另请参阅

fromHsl() convertTo() isValid() HSL 颜色模型

toHsv()#
返回类型：

QColor

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

另请参阅

fromHsv() convertTo() isValid() HSV 颜色模型

toRgb()#
返回类型：

QColor

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

toTuple()#
返回类型：

对象

value()#
返回类型：

int

返回此颜色的值颜色分量。

另请参阅

valueF() getHsv() HSV 颜色模型

valueF()#
返回类型：

float

返回此颜色的值颜色分量。

另请参阅

value() getHsvF() HSV 颜色 模型

yellow()#
返回类型：

int

返回该颜色的黄色成分。

另请参阅

yellowF() getCmyk() CMYK 颜色 模型

yellowF()#
返回类型：

float

返回该颜色的黄色成分。

另请参阅

yellow() getCmykF() CMYK 颜色 模型