PySide6.QtGui.QColor

class 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-cmyk3

qcolor-cmyk3

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值三元组（r, g, b）的无符号整数的typedef。请注意，它也可以保存一个alpha通道的值（更多信息，请参见Alpha-Blended Drawing部分）。qRed()、qBlue() 和 qGreen() 函数返回给定 QRgb 值的相应分量，而 qRgb() 和 qRgba() 函数根据给定的分量值创建并返回 QRgb 三元组。最后，qAlpha() 函数返回提供的 QRgb 的alpha分量，qGray() 函数根据给定值计算并返回一个灰度值。

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

有关绘画的更多信息，请参阅Paint System文档。

整数与浮点数精度

QColor 支持浮点精度，并提供了所有颜色组件的浮点版本函数，例如 getRgbF()、hueF() 和 fromCmykF()。请注意，由于组件是使用16位整数存储的，因此在使用例如 setRgbF() 设置的值与 getRgbF() 函数返回的值之间可能存在由于舍入引起的微小偏差。

虽然基于整数的函数接受0-255范围内的值（除了hue()，其值必须在0-359范围内），但浮点函数接受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通道可以使用alpha()和setAlpha()函数来获取和设置，如果其值是整数；如果其值是浮点数，则使用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（非零像素值）是用于在QBitmaps中绘制的特殊颜色。使用QColorConstants::Color0绘制会将位图位设置为0（透明；即背景），而使用QColorConstants::Color1绘制会将位设置为1（不透明；即前景）。

QColorConstants::Transparent 用于表示透明像素。当使用此值进行绘制时，将使用适合当前底层像素格式的像素值。

由于历史原因，20种预定义颜色也可以在Qt::GlobalColor枚举中使用。

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

扩展的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，S=255。

Qt 对于无色颜色返回的色调值为 -1。如果你传递的色调值过大，Qt 会强制将其调整到范围内。色调 360 或 720 被视为 0；色调 540 被视为 180。

除了标准的HSV模型外，Qt还提供了一个alpha通道来支持alpha-blended drawing。

HSL 颜色模型

HSL 与 HSV 类似，但是 HSL 不是使用 Value 参数，而是指定了一个 Lightness 参数，该参数对颜色的亮度映射方式有所不同。

同样地，对于相同的颜色，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通道来支持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__()

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

无效颜色的alpha值未指定。

另请参阅

isValid()

__init__(name)
Parameters:

name – QLatin1String

__init__(rgba64)
Parameters:

rgba64 – QRgba64

使用值rgba64构造颜色。

另请参阅

fromRgba64()

__init__(name)
Parameters:

name – str

__init__(color)
Parameters:

颜色 – 对象

__init__(color)
Parameters:

颜色 – GlobalColor

这是一个重载函数。

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

另请参阅

isValid() 预定义 颜色

__init__(name)
Parameters:

name – str

使用给定的name以与setNamedColor()相同的方式构造一个命名颜色。

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

__init__(rgb)
Parameters:

rgb – 整数

__init__(r, g, b[, a=255])
Parameters:

  • r – 整数

  • g – 整数

  • b – 整数

  • a – 整数

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

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

另请参阅

setRgba() isValid()

__init__(spec, a1, a2, a3, a4[, a5=0])
Parameters:

  • spec – Spec

  • a1 – 整数

  • a2 – int

  • a3 – int

  • a4 – int

  • a5 – 整数

__reduce__()
Return type:

字符串

__repr__()
Return type:

字符串

__setstate__(arg__1)
Parameters:

arg__1 – 对象

Return type:

对象

__str__()
Return type:

字符串

alpha()
Return type:

整数

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

另请参阅

setAlpha() alphaF() Alpha混合 绘图

alphaF()
Return type:

浮点数

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

另请参阅

setAlphaF() alpha() Alpha混合 绘图

black()
Return type:

整数

返回此颜色的黑色分量。

另请参阅

blackF() getCmyk() CMYK 颜色 模型

blackF()
Return type:

浮点数

返回此颜色的黑色分量。

另请参阅

black() getCmykF() CMYK 颜色模型

blue()
Return type:

整数

返回此颜色的蓝色分量。

另请参阅

setBlue() blueF() getRgb()

blueF()
Return type:

浮点数

返回此颜色的蓝色分量。

另请参阅

setBlueF() blue() getRgbF()

static colorNames()
Return type:

字符串列表

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

另请参阅

预定义 颜色

convertTo(colorSpec)
Parameters:

colorSpec – Spec

Return type:

QColor

创建此颜色的副本，格式由colorSpec指定。

cyan()
Return type:

整数

返回此颜色的青色分量。

另请参阅

cyanF() getCmyk() CMYK 颜色 模型

cyanF()
Return type:

浮点数

返回此颜色的青色分量。

另请参阅

cyan() getCmykF() CMYK 颜色模型

darker([f=200])
Parameters:

f – 整数

Return type:

QColor

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

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

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

另请参阅

lighter() isValid()

static fromCmyk(c, m, y, k[, a=255])
Parameters:

  • c – 整数

  • m – 整数

  • y – 整数

  • k – int

  • a – 整数

Return type:

QColor

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

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

另请参阅

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

static fromCmykF(c, m, y, k[, a=1.0])
Parameters:

  • c – 浮点数

  • m – 浮点数

  • y – 浮点数

  • k – 浮点数

  • a – 浮点数

Return type:

QColor

这是一个重载函数。

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

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

另请参阅

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

static fromHsl(h, s, l[, a=255])
Parameters:

  • h – 整数

  • s – 整数

  • l – 整数

  • a – 整数

Return type:

QColor

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

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

另请参阅

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

static fromHslF(h, s, l[, a=1.0])
Parameters:

  • h – 浮点数

  • s – 浮点数

  • l – 浮点数

  • a – 浮点数

Return type:

QColor

这是一个重载函数。

静态便捷函数，返回由HSV颜色值构造的QColor，包括h（色调）、s（饱和度）、l（亮度）和a（alpha通道，即透明度）。

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

另请参阅

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

static fromHsv(h, s, v[, a=255])
Parameters:

  • h – 整数

  • s – 整数

  • v – 整数

  • a – 整数

Return type:

QColor

静态便捷函数，返回一个由HSV颜色值构造的QColor，h（色调），s（饱和度），v（明度），以及a（alpha通道，即透明度）。

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

另请参阅

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

static fromHsvF(h, s, v[, a=1.0])
Parameters:

  • h – 浮点数

  • s – 浮点数

  • v – 浮点数

  • a – 浮点数

Return type:

QColor

这是一个重载函数。

静态便捷函数，返回一个由HSV颜色值构造的QColor，包括h（色调）、s（饱和度）、v（明度）和a（alpha通道，即透明度）。

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

另请参阅

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

static fromRgb(rgb)
Parameters:

rgb – 整数

Return type:

QColor

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

rgb 的 alpha 组件被忽略（即自动设置为 255），使用 fromRgba() 函数以包含由给定 QRgb 值指定的 alpha 通道。

static fromRgb(r, g, b[, a=255])
Parameters:

  • r – 整数

  • g – 整数

  • b – 整数

  • a – 整数

Return type:

QColor

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

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

static fromRgbF(r, g, b[, a=1.0])
Parameters:

  • r – 浮点数

  • g – 浮点数

  • b – 浮点数

  • a – 浮点数

Return type:

QColor

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

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

static fromRgba(rgba)
Parameters:

rgba – 整数

Return type:

QColor

静态便捷函数，返回从给定的QRgb值rgba构造的QColor。

与fromRgb()函数不同，给定的QRgb值中指定的alpha通道被包含在内。

static fromRgba64(rgba)
Parameters:

rgba – QRgba64

Return type:

QColor

静态便捷函数，返回从给定的QRgba64值rgba64构造的QColor。

static fromRgba64(r, g, b[, a=USHRT_MAX])
Parameters:

  • r – 整数

  • g – 整数

  • b – 整数

  • a – 整数

Return type:

QColor

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

static fromString(name)
Parameters:

name – str

Return type:

QColor

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

  • #RGB（R、G和B各为一个十六进制数字）

  • #RRGGBB

  • #AARRGGBB（自5.2版本起）

  • #RRRGGGBBB

  • #RRRRGGGGBBBB

  • 从万维网联盟提供的SVG颜色关键字名称列表中选择的颜色名称；例如，“steelblue”或“gainsboro”。这些颜色名称在所有平台上都有效。请注意，这些颜色名称不与Qt::GlobalColor枚举定义的颜色相同，例如“green”和Qt::green并不指代相同的颜色。

  • transparent - 表示没有颜色。

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

另请参阅

isValidColorName()

getCmyk()
Return type:

PyObject*

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

这些组件可以分别使用cyan()、magenta()、yellow()、black()和alpha()函数来获取。

另请参阅

setCmyk() CMYK 颜色模型

getCmykF()
Return type:

PyObject*

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

这些组件可以分别使用 cyanF()、magentaF()、yellowF()、blackF() 和 alphaF() 函数来获取。

另请参阅

setCmykF() CMYK 颜色模型

getHsl()
Return type:

PyObject*

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

这些组件可以分别使用 hslHue()、hslSaturation()、lightness() 和 alpha() 函数来获取。

另请参阅

getHslF() setHsl() HSL 颜色 模型

getHslF()
Return type:

PyObject*

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

这些组件可以分别使用 hslHueF()、hslSaturationF()、lightnessF() 和 alphaF() 函数来获取。

另请参阅

getHsl() setHslF() HSL 颜色 模型

getHsv()
Return type:

PyObject*

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

这些组件可以分别使用hue()、saturation()、value()和alpha()函数来获取。

另请参阅

setHsv() HSV 颜色 模型

getHsvF()
Return type:

PyObject*

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

这些组件可以分别使用hueF()、saturationF()、valueF()和alphaF()函数来获取。

另请参阅

setHsv() HSV 颜色 模型

getRgb()
Return type:

PyObject*

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

这些组件可以分别使用red()、green()、blue()和alpha()函数来获取。

另请参阅

rgb() setRgb()

getRgbF()
Return type:

PyObject*

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

这些组件可以分别使用 redF()、greenF()、blueF() 和 alphaF() 函数来获取。

另请参阅

rgb() setRgb()

green()
Return type:

整数

返回此颜色的绿色分量。

greenF()
Return type:

浮点数

返回此颜色的绿色分量。

hslHue()
Return type:

整数

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

另请参阅

hslHueF() hsvHue() getHsl() HSL 颜色 模型

hslHueF()
Return type:

浮点数

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

hslSaturation()
Return type:

整数

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

另请参阅

hslSaturationF() hsvSaturation() getHsl() HSL 颜色 模型

hslSaturationF()
Return type:

浮点数

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

另请参阅

hslSaturation() hsvSaturationF() getHslF() HSL 颜色 模型

hsvHue()
Return type:

整数

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

另请参阅

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

hsvHueF()
Return type:

浮点数

返回此颜色的色调组件。

另请参阅

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

hsvSaturation()
Return type:

整数

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

另请参阅

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

hsvSaturationF()
Return type:

浮点数

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

另请参阅

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

hue()
Return type:

整数

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

颜色被隐式转换为HSV。

另请参阅

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

hueF()
Return type:

浮点数

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

颜色被隐式转换为HSV。

另请参阅

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

isValid()
Return type:

布尔

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

static isValidColor(arg__1)
Parameters:

arg__1 – QLatin1String

Return type:

布尔

注意

此函数已弃用。

static isValidColor(name)
Parameters:

name – str

Return type:

布尔

注意

此函数已弃用。

这是一个重载函数。

请使用 isValidColorName() 代替。

static isValidColor(name)
Parameters:

name – str

Return type:

布尔

注意

此函数已弃用。

请使用 isValidColorName() 代替。

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

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

另请参阅

setNamedColor()

static isValidColorName(name)
Parameters:

name – str

Return type:

布尔

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

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

另请参阅

fromString()

lighter([f=150])
Parameters:

f – 整数

Return type:

QColor

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

如果factor大于100，此函数返回较浅的颜色。将factor设置为150会返回一个亮度增加50%的颜色。如果factor小于100，返回的颜色会较暗，但我们建议使用darker()函数来实现此目的。如果factor为0或负数，返回值未指定。

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

另请参阅

darker() isValid()

lightness()
Return type:

整数

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

另请参阅

lightnessF() getHsl()

lightnessF()
Return type:

浮点数

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

另请参阅

value() getHslF()

magenta()
Return type:

整数

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

另请参阅

magentaF() getCmyk() CMYK 颜色 模型

magentaF()
Return type:

浮点数

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

另请参阅

magenta() getCmykF() CMYK 颜色 模型

name([format=QColor.NameFormat.HexRgb])
Parameters:

format – NameFormat

Return type:

字符串

返回指定format中的颜色名称。

另请参阅

fromString() NameFormat

__ne__(c)
Parameters:

c – QColor

Return type:

布尔

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

ExtendedRgb 和 Rgb 规范在此上下文中被认为是匹配的。

另请参阅

spec()

__eq__(c)
Parameters:

c – QColor

Return type:

布尔

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

ExtendedRgb 和 Rgb 规范在此上下文中被认为是匹配的。

另请参阅

spec()

red()
Return type:

整数

返回此颜色的红色分量。

另请参阅

setRed() redF() getRgb()

redF()
Return type:

浮点数

返回此颜色的红色分量。

另请参阅

setRedF() red() getRgbF()

rgb()
Return type:

整数

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

另请参阅

setRgb() getRgb() rgba()

rgba()
Return type:

整数

返回颜色的RGB值，包括其透明度。

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

另请参阅

setRgba() rgb() rgba64()

rgba64()
Return type:

QRgba64

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

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

另请参阅

setRgba64() rgba() rgb()

saturation()
Return type:

整数

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

颜色被隐式转换为HSV。

另请参阅

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

saturationF()
Return type:

浮点数

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

颜色被隐式转换为HSV。

另请参阅

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

setAlpha(alpha)
Parameters:

alpha – 整数

将此颜色的透明度设置为alpha。整数透明度在0-255范围内指定。

另请参阅

alpha() alphaF() Alpha混合 绘图

setAlphaF(alpha)
Parameters:

alpha – 浮点数

将此颜色的透明度设置为 alpha。浮点数 alpha 的范围为 0.0-1.0。

另请参阅

alphaF() alpha() Alpha混合 绘图

setBlue(blue)
Parameters:

蓝色 – 整数

将此颜色的蓝色分量设置为blue。整数分量的范围是0-255。

另请参阅

blue() blueF() setRgb()

setBlueF(blue)
Parameters:

蓝色 – 浮点数

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

另请参阅

blueF() blue() setRgbF()

setCmyk(c, m, y, k[, a=255])
Parameters:

  • c – 整数

  • m – 整数

  • y – 整数

  • k – int

  • a – 整数

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

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

另请参阅

getCmyk() setCmykF() CMYK 颜色 模型

setCmykF(c, m, y, k[, a=1.0])
Parameters:

  • c – 浮点数

  • m – 浮点数

  • y – 浮点数

  • k – 浮点数

  • a – 浮点数

这是一个重载函数。

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

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

另请参阅

getCmykF() setCmyk() CMYK 颜色 模型

setGreen(green)
Parameters:

绿色 – 整数

将此颜色的绿色分量设置为green。整数分量的范围指定为0-255。

另请参阅

green() greenF() setRgb()

setGreenF(green)
Parameters:

绿色 – 浮点数

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

另请参阅

greenF() green() setRgbF()

setHsl(h, s, l[, a=255])
Parameters:

  • h – 整数

  • s – 整数

  • l – 整数

  • a – 整数

设置一个HSL颜色值；h 是色调，s 是饱和度，l 是亮度，a 是HSL颜色的透明度分量。

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

另请参阅

getHsl() setHslF()

setHslF(h, s, l[, a=1.0])
Parameters:

  • h – 浮点数

  • s – 浮点数

  • l – 浮点数

  • a – 浮点数

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

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

另请参阅

getHslF() setHsl()

setHsv(h, s, v[, a=255])
Parameters:

  • h – 整数

  • s – 整数

  • v – 整数

  • a – 整数

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

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

另请参阅

getHsv() setHsvF() HSV 颜色 模型

setHsvF(h, s, v[, a=1.0])
Parameters:

  • h – 浮点数

  • s – 浮点数

  • v – 浮点数

  • a – 浮点数

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

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

另请参阅

getHsvF() setHsv() HSV 颜色 模型

setNamedColor(name)
Parameters:

name – QLatin1String

注意

此函数已弃用。

setNamedColor(name)
Parameters:

name – str

注意

此函数已弃用。

这是一个重载函数。

请使用 fromString() 代替。

setNamedColor(name)
Parameters:

name – str

注意

此函数已弃用。

请使用fromString()代替。

将此QColor的RGB值设置为name，它可以是以下格式之一：

  • #RGB（R、G和B各为一个十六进制数字）

  • #RRGGBB

  • #AARRGGBB（自5.2版本起）

  • #RRRGGGBBB

  • #RRRRGGGGBBBB

  • 从万维网联盟提供的SVG颜色关键字名称列表中选择的颜色名称；例如，“steelblue”或“gainsboro”。这些颜色名称在所有平台上都有效。请注意，这些颜色名称不与Qt::GlobalColor枚举定义的颜色相同，例如“green”和Qt::green并不指代相同的颜色。

  • transparent - 表示没有颜色。

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

另请参阅

QColor() name() isValid()

setRed(red)
Parameters:

红色 – 整数

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

另请参阅

red() redF() setRgb()

setRedF(red)
Parameters:

红色 – 浮点数

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

另请参阅

redF() red() setRgbF()

setRgb(rgb)
Parameters:

rgb – 整数

这是一个重载函数。

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

setRgb(r, g, b[, a=255])
Parameters:

  • r – 整数

  • g – 整数

  • b – 整数

  • a – 整数

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

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

另请参阅

rgb() getRgb() setRgbF()

setRgbF(r, g, b[, a=1.0])
Parameters:

  • r – 浮点数

  • g – 浮点数

  • b – 浮点数

  • a – 浮点数

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

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

另请参阅

rgb() getRgbF() setRgb()

setRgba(rgba)
Parameters:

rgba – 整数

将RGB值设置为rgba，包括其透明度。

另请参阅

rgba() rgb() setRgba64()

setRgba64(rgba)
Parameters:

rgba – QRgba64

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

另请参阅

setRgba() rgba64()

spec()
Return type:

Spec

返回颜色的指定方式。

另请参阅

Spec convertTo()

toCmyk()
Return type:

QColor

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

另请参阅

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

toExtendedRgb()
Return type:

QColor

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

另请参阅

toRgb convertTo()

toHsl()
Return type:

QColor

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

另请参阅

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

toHsv()
Return type:

QColor

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

另请参阅

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

toRgb()
Return type:

QColor

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

toTuple()
Return type:

对象

value()
Return type:

整数

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

另请参阅

valueF() getHsv() HSV 颜色 模型

valueF()
Return type:

浮点数

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

另请参阅

value() getHsvF() HSV 颜色 模型

yellow()
Return type:

整数

返回此颜色的黄色分量。

另请参阅

yellowF() getCmyk() CMYK 颜色 模型

yellowF()
Return type:

浮点数

返回此颜色的黄色分量。

另请参阅

yellow() getCmykF() CMYK 颜色 模型