En esta página

QColor Class

La clase QColor proporciona colores basados en valores RGB, HSV o CMYK. Más información...

Encabezado: #include <QColor>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui

Tipos públicos

enum NameFormat { HexRgb, HexArgb }
enum Spec { Rgb, Hsv, Cmyk, Hsl, ExtendedRgb, Invalid }

Funciones públicas

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

Miembros públicos estáticos

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

Descripción detallada

Normalmente, un color se especifica en términos de componentes RGB (rojo, verde y azul), pero también es posible especificarlo en términos de componentes HSV (tono, saturación y valor) y CMYK (cian, magenta, amarillo y negro). Además, un color se puede especificar utilizando un nombre de color. El nombre del color puede ser cualquiera de los nombres de color de SVG 1.0.

RGBHSVCMYK
Rueda de colores con valores RGBRueda de colores con valores HSVRueda de colores con valores CMYK

El constructor QColor crea el color a partir de valores RGB. Para crear un QColor a partir de valores HSV o CMYK, utilice las funciones toHsv() y toCmyk(), respectivamente. Estas funciones devuelven una copia del color en el formato deseado. Además, las funciones estáticas fromRgb(), fromHsv() y fromCmyk() crean colores a partir de los valores especificados. Como alternativa, un color puede convertirse a cualquiera de los tres formatos utilizando la función convertTo(), que devuelve una copia del color en el formato deseado, o cualquiera de las funciones setRgb(), setHsv() y setCmyk(), que modifican el formato de dicho color. La función spec() indica cómo se especificó el color.

Se puede establecer un color pasando una cadena RGB (como «#112233»), una cadena ARGB (como «#ff112233») o un nombre de color (como «blue») a la función fromString(). Los nombres de los colores proceden de los nombres de colores de SVG 1.0. La función name() devuelve el nombre del color en el formato «#RRGGBB». Los colores también se pueden establecer utilizando setRgb(), setHsv() y setCmyk(). Para obtener un color más claro o más oscuro, utilice las funciones lighter() y darker(), respectivamente.

La función isValid() indica si un QColor es válido o no. Por ejemplo, un color RGB con valores fuera del rango es inválido. Por motivos de rendimiento, QColor suele ignorar los colores inválidos y, por ese motivo, el resultado de utilizar un color inválido es indefinido.

Los componentes del color se pueden obtener individualmente, por ejemplo, con red(), hue() y cyan(). Los valores de los componentes del color también se pueden obtener de una sola vez utilizando las funciones getRgb(), getHsv() y getCmyk(). Utilizando el modelo de color RGB, también se puede acceder a los componentes del color con rgb().

Existen varios elementos no miembros relacionados: QRgb es una definición de tipo (typedef) para un entero sin signo que representa el triplete de valores RGB (r, g, b). Ten en cuenta que también puede contener un valor para el canal alfa (para más información, consulta la sección Alpha-Blended Drawing ). Las funciones qRed(), qBlue() y qGreen() devuelven el componente respectivo del valor QRgb dado, mientras que las funciones qRgb() y qRgba() crean y devuelven el trío QRgb basándose en los valores de los componentes proporcionados. Por último, la función qAlpha() devuelve el componente alfa del QRgb proporcionado, y la función qGray() calcula y devuelve un valor de gris basándose en el valor dado.

QColor es independiente de la plataforma y del dispositivo.

Para obtener más información sobre el dibujo en general, consulta la documentación del sistema de dibujo.

Precisión entera frente a precisión de coma flotante

QColor admite la precisión en coma flotante y proporciona versiones en coma flotante de todas las funciones de componentes de color, por ejemplo: ` getRgbF()`, ` hueF()` y ` fromCmykF()`. Tenga en cuenta que, dado que los componentes se almacenan utilizando enteros de 16 bits, puede haber pequeñas desviaciones entre los valores establecidos mediante, por ejemplo, setRgbF() y los valores devueltos por la función getRgbF() debido al redondeo.

Mientras que las funciones basadas en enteros admiten valores en el intervalo 0-255 (excepto ` hue()`, que debe tener valores dentro del intervalo 0-359), las funciones de punto flotante aceptan valores en el intervalo 0,0 - 1,0.

Dibujo con mezcla alfa

QColor también admite contornos y rellenos con mezcla alfa. El canal alfa de un color especifica el efecto de transparencia: 0 representa un color totalmente transparente, mientras que 255 representa un color totalmente opaco. Por ejemplo:

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

El código anterior genera el siguiente resultado:

Una imagen que contiene cuatro secciones cuadradas, con los colores morado, azul, rojo y blanco

El canal alfa de un color se puede recuperar y establecer utilizando las funciones ` alpha()` y ` setAlpha()` si su valor es un entero, y ` alphaF()` y ` setAlphaF()` si su valor es un número de tipo flotante. Por defecto, el canal alfa se establece en 255 (opaco). Para recuperar y establecer todos los componentes de color RGB (incluido el canal alfa) de una sola vez, utiliza las funciones rgba() y setRgba().

Colores predefinidos

Hay 20 objetos QColor predefinidos en el espacio de nombres QColorConstants, entre los que se incluyen el negro, el blanco, los colores primarios y secundarios, versiones más oscuras de estos colores y tres tonos de gris. Además, el espacio de nombres QColorConstants::Svg define objetos QColor para los nombres de las palabras clave de color estándar de SVG.

Colores de Qt

Los colores QColorConstants::Color0, QColorConstants::Color1 y QColorConstants::Transparent se utilizan para fines especiales.

QColorConstants::Color0 (valor de píxel cero) y QColorConstants::Color1 (valor de píxel distinto de cero) son colores especiales para dibujar en QBitmaps. Al pintar con QColorConstants::Color0 se establecen los bits del mapa de bits en 0 (transparente; es decir, fondo), y al pintar con c{QColorConstants::Color1} se establecen los bits en 1 (opaco; es decir, primer plano).

QColorConstants::Transparent Se utiliza para indicar un píxel transparente. Al pintar con este valor, se utilizará un valor de píxel adecuado para el formato de píxeles subyacente que se esté utilizando.

Por razones históricas, los 20 colores predefinidos también están disponibles en la enumeración Qt::GlobalColor.

Por último, QColor reconoce una variedad de nombres de colores (como cadenas); la función estática colorNames() devuelve una lista QStringList de los nombres de colores que QColor conoce.

El modelo de color RGB ampliado

El modelo de color RGB ampliado, también conocido como espacio de color scRGB, es idéntico al modelo de color RGB, salvo que permite valores inferiores a 0,0 y superiores a 1,0. Esto permite representar colores que, de otro modo, quedarían fuera del rango del espacio de color RGB, pero sigue utilizando los mismos valores para los colores dentro de dicho espacio.

El modelo de color HSV

El modelo RGB está orientado al hardware. Su representación se acerca a lo que muestran la mayoría de los monitores. Por el contrario, el modelo HSV representa el color de una forma más adecuada a la percepción humana del color. Por ejemplo, las relaciones «más intenso que», «más oscuro que» y «opuesto a» se expresan fácilmente en HSV, pero resultan mucho más difíciles de expresar en RGB.

El HSV, al igual que el RGB, tiene tres componentes:

  • H, que corresponde al matiz, está en el rango de 0 a 359 si el color es cromático (no gris), o carece de significado si es gris. Representa los grados de la rueda de colores con la que la mayoría de la gente está familiarizada. El rojo es 0 (grados), el verde es 120 y el azul es 240.

    Rueda de colores que muestra valores de matiz del 0 al 300

  • S, que significa «saturación», está comprendido entre 0 y 255, y cuanto mayor es el valor, más intenso es el color. Los colores grisáceos tienen una saturación cercana a 0; los colores muy intensos tienen una saturación cercana a 255.

    Gradiente de saturación de gris a azul

  • V, de valor, está en el rango de 0 a 255 y representa la claridad o el brillo del color. 0 es negro; 255 es lo más alejado posible del negro.

    Gradiente de valor de negro a blanco

He aquí algunos ejemplos: el rojo puro es H=0, S=255, V=255; un rojo oscuro, que se inclina ligeramente hacia el magenta, podría ser H=350 (equivalente a -10), S=255, V=180; un rojo claro grisáceo podría tener H alrededor de 0 (por ejemplo, 350-359 o 0-10), S entre 50 y 100, y V=255.

Qt devuelve un valor de matiz de -1 para los colores acromáticos. Si se pasa un valor de matiz demasiado grande, Qt lo ajusta al rango permitido. Los matices 360 o 720 se tratan como 0; el matiz 540 se trata como 180.

Además del modelo HSV estándar, Qt proporciona un canal alfa para representar el color « alpha-blended drawing ».

El modelo de color HSL

El modelo HSL es similar al HSV; sin embargo, en lugar del parámetro «Value», el HSL especifica un parámetro de «Lightness» (luminosidad) que se corresponde de forma ligeramente diferente con el brillo del color.

Del mismo modo, el valor de saturación HSL no suele ser el mismo que el valor de saturación HSV para un mismo color. hslSaturation() proporciona el valor de saturación HSL del color, mientras que saturation() y hsvSaturation() proporcionan el valor de saturación HSV.

El valor del tono se define como el mismo tanto en HSL como en HSV.

El modelo de color CMYK

Mientras que los modelos de color RGB y HSV se utilizan para la visualización en monitores de ordenador, el modelo CMYK se emplea en el proceso de impresión en cuatricromía de las imprentas y en algunos dispositivos de impresión en papel.

El modelo CMYK tiene cuatro componentes, todos en el rango de 0 a 255: cian (C), magenta (M), amarillo (Y) y negro (K). El cian, el magenta y el amarillo se denominan colores sustractivos; el modelo de color CMYK crea el color partiendo de una superficie blanca y restando luego el color mediante la aplicación de los componentes adecuados. Si bien la combinación de cian, magenta y amarillo da como resultado el color negro, al restar uno o más de ellos se obtiene cualquier otro color. Al combinarse en distintos porcentajes, estos tres colores pueden crear todo el espectro de colores.

Mezclar el 100 % de cian, magenta y amarillo produce negro, pero el resultado es insatisfactorio, ya que desperdicia tinta, aumenta el tiempo de secado y da un color turbio al imprimir. Por ese motivo, en la impresión profesional se añade el negro para proporcionar un tono negro sólido; de ahí el término «proceso de cuatro colores».

Además del modelo CMYK estándar, Qt proporciona un canal alfa para ofrecer la función « alpha-blended drawing ».

Véase también QPalette, QBrush y QColorConstants.

Documentación sobre tipos de miembros

enum QColor::NameFormat

Cómo dar formato al resultado de la función name()

ConstanteValorDescripción
QColor::HexRgb0#RRGGBB Un carácter «#» seguido de tres números hexadecimales de dos dígitos (por ejemplo, #RRGGBB).
QColor::HexArgb1#AARRGGBB Un carácter «#» seguido de cuatro números hexadecimales de dos dígitos (es decir, #AARRGGBB).

Véase también name().

enum QColor::Spec

El tipo de color especificado: RGB, RGB ampliado, HSV, CMYK o HSL.

ConstanteValor
QColor::Rgb1
QColor::Hsv2
QColor::Cmyk3
QColor::Hsl4
QColor::ExtendedRgb5
QColor::Invalid0

Véase también spec() y convertTo().

Documentación de funciones de miembro

[constexpr noexcept] QColor::QColor()

Crea un color no válido con el valor RGB (0, 0, 0). Un color no válido es aquel que no está configurado correctamente para el sistema de ventanas subyacente.

El valor alfa de un color no válido no está especificado.

Véase también isValid().

[noexcept] QColor::QColor(QRgb color)

Crea un color con el valor color. El componente alfa se ignora y se establece como opaco.

Véase también fromRgb() y isValid().

[noexcept] QColor::QColor(QRgba64 rgba64)

Crea un color con el valor « rgba64 ».

Véase también fromRgba64().

QColor::QColor(const QString &name)

Crea un color con nombre de la misma forma que ` fromString()` utilizando el ` name` proporcionado.

El color queda inválido si no se puede analizar el name.

Véanse también fromString(), name() y isValid().

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

Crea un color con los valores RGB r, g, b y el valor del canal alfa (transparencia) a.

El color no se crea si alguno de los argumentos no es válido.

Véanse también setRgba() y isValid().

QColor::QColor(QLatin1StringView name)

Crea un color con nombre de la misma forma que ` fromString()` utilizando el ` name` proporcionado.

Esta es una función sobrecargada.

Véanse también fromString(), name() y isValid().

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

Crea un nuevo color con el valor de color « color ».

Esta es una función sobrecargada.

Véase también isValid() y Predefined Colors.

QColor::QColor(const char *name)

Crea un color con nombre de la misma forma que ` fromString()` utilizando el ` name` indicado.

Esta es una función sobrecargada.

Véanse también fromString(), name() y isValid().

[noexcept] int QColor::alpha() const

Devuelve el componente de color alfa de este color.

Véase también setAlpha(), alphaF() y Alpha-Blended Drawing.

[noexcept] float QColor::alphaF() const

Devuelve el componente de color alfa de este color.

Véase también setAlphaF(), alpha() y Alpha-Blended Drawing.

[noexcept] int QColor::black() const

Devuelve el componente de negro de este color.

Véase también blackF(), getCmyk() y The CMYK Color Model.

[noexcept] float QColor::blackF() const

Devuelve el componente de negro de este color.

Véase también black(), getCmykF() y The CMYK Color Model.

[noexcept] int QColor::blue() const

Devuelve el componente de color azul de este color.

Véase también setBlue(), blueF() y getRgb().

[noexcept] float QColor::blueF() const

Devuelve el componente de color azul de este color.

Véase también setBlueF(), blue() y getRgbF().

[static] QStringList QColor::colorNames()

Devuelve un objeto ` QStringList ` que contiene los nombres de colores que reconoce Qt.

Véase también ` Predefined Colors`.

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

Crea una copia de este color en el formato especificado en colorSpec.

Véase también spec(), toCmyk(), toHsv(), toRgb() y isValid().

[noexcept] int QColor::cyan() const

Devuelve el componente de color cian de este color.

Véase también cyanF(), getCmyk() y The CMYK Color Model.

[noexcept] float QColor::cyanF() const

Devuelve el componente de color cian de este color.

Véase también cyan(), getCmykF() y The CMYK Color Model.

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

Devuelve un color más oscuro (o más claro), pero no modifica este objeto.

Si el valor de « factor » es superior a 100, esta función devuelve un color más oscuro. Al establecer ` factor ` en 300, se devuelve un color con un tercio del brillo. Si ` factor ` es menor que 100, el color devuelto es más claro, pero recomendamos utilizar la función ` lighter()` para este fin. Si ` factor ` es 0 o un valor negativo, el valor devuelto no está especificado.

La función convierte el color actual a HSV, divide el valor del componente (V) entre factor y vuelve a convertir el color a su especificación original.

Véanse también lighter() y isValid().

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

Función estática de conveniencia que devuelve un objeto ` QColor ` construido a partir de los valores de color CMYK proporcionados: c (cian), m (magenta), y (amarillo), k (negro) y a (canal alfa, es decir, transparencia).

Todos los valores deben estar comprendidos entre 0 y 255.

Véase también toCmyk(), fromCmykF(), isValid() y The CMYK Color Model.

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

Función estática de conveniencia que devuelve un objeto ` QColor ` construido a partir de los valores de color CMYK proporcionados: c (cian), m (magenta), y (amarillo), k (negro) y a (canal alfa, es decir, transparencia).

Todos los valores deben estar comprendidos entre 0,0 y 1,0.

Véase también toCmyk(), fromCmyk(), isValid() y The CMYK Color Model.

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

Función estática de conveniencia que devuelve un objeto ` QColor ` construido a partir de los valores de color HSV: ` h ` (tono), ` s ` (saturación), ` l ` (luminosidad) y ` a ` (canal alfa, es decir, transparencia).

Los valores de s, l y a deben estar todos en el intervalo 0-255; el valor de h debe estar en el intervalo 0-359.

Véanse también toHsl(), fromHslF(), isValid() y The HSL Color Model.

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

Función estática de conveniencia que devuelve un objeto ` QColor ` construido a partir de los valores de color HSV: ` h ` (tono), ` s ` (saturación), ` l ` (luminosidad) y ` a ` (canal alfa, es decir, transparencia).

Todos los valores deben estar comprendidos entre 0,0 y 1,0.

Véase también toHsl(), fromHsl(), isValid() y The HSL Color Model.

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

Función estática de conveniencia que devuelve un objeto ` QColor ` construido a partir de los valores de color HSV: ` h ` (tono), ` s ` (saturación), ` v ` (valor) y ` a ` (canal alfa, es decir, transparencia).

Los valores de s, v y a deben estar todos comprendidos entre 0 y 255; el valor de h debe estar comprendido entre 0 y 359.

Véanse también toHsv(), fromHsvF(), isValid() y The HSV Color Model.

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

Función estática de conveniencia que devuelve un objeto ` QColor ` construido a partir de los valores de color HSV: h (tono), s (saturación), v (valor) y a (canal alfa, es decir, transparencia).

Todos los valores deben estar comprendidos entre 0,0 y 1,0.

Véase también toHsv(), fromHsv(), isValid() y The HSV Color Model.

[static noexcept] QColor QColor::fromRgb(QRgb rgb)

Función estática de conveniencia que devuelve un objeto ` QColor ` construido a partir del valor ` QRgb ` proporcionado ` rgb`.

Se ignora el componente alfa de ` rgb ` (es decir, se establece automáticamente en 255); utilice la función ` fromRgba()` para incluir el canal alfa especificado por el valor ` QRgb ` dado.

Véanse también fromRgba(), fromRgbF(), toRgb() y isValid().

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

Función estática de conveniencia que devuelve un objeto ` QColor ` construido a partir de los valores de color RGB: ` r ` (rojo), ` g ` (verde), ` b ` (azul) y ` a ` (canal alfa, es decir, transparencia).

Todos los valores deben estar comprendidos entre 0 y 255.

Véase también toRgb(), fromRgba64(), fromRgbF() y isValid().

[static noexcept] QColor QColor::fromRgba64(QRgba64 rgba64)

Función estática de conveniencia que devuelve un objeto ` QColor ` construido a partir del valor ` QRgba64 ` proporcionado ` rgba64`.

Véanse también fromRgb(), fromRgbF(), toRgb() y isValid().

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

Función estática de conveniencia que devuelve un objeto ` QColor ` construido a partir de los valores de color RGBA64: ` r ` (rojo), ` g ` (verde), ` b ` (azul) y ` a ` (canal alfa, es decir, transparencia).

Véase también fromRgb(), fromRgbF(), toRgb() y isValid().

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

Función estática de conveniencia que devuelve un objeto ` QColor ` construido a partir de los valores de color RGB: ` r ` (rojo), ` g ` (verde), ` b ` (azul) y ` a ` (canal alfa, es decir, transparencia).

El valor alfa debe estar comprendido entre 0,0 y 1,0. Si alguno de los demás valores se encuentra fuera del intervalo 0,0-1,0, el modelo de color se establecerá como ExtendedRgb.

Véanse también fromRgb(), fromRgba64(), toRgb() y isValid().

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

Función estática de conveniencia que devuelve un objeto ` QColor ` construido a partir del valor ` QRgb ` proporcionado ` rgba`.

A diferencia de la función fromRgb(), se incluye el canal alfa especificado por el valor QRgb proporcionado.

Véanse también fromRgb(), fromRgba64() y isValid().

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

Devuelve un valor RGB « QColor » extraído de name, que puede estar en uno de estos formatos:

  • #RGB (cada uno de los valores R, G y B es un único dígito hexadecimal)
  • #RRGGBB
  • #AARRGGBB (desde la versión 5.2)
  • #RRRGGGBBB
  • #RRRRGGGGBBBB
  • Un nombre de la lista de colores definida en la lista de nombres de palabras clave de color SVG proporcionada por el World Wide Web Consortium; por ejemplo, «steelblue» o «gainsboro». Estos nombres de color funcionan en todas las plataformas. Ten en cuenta que estos nombres de colores no son los mismos que los definidos por las enumeraciones de Qt::GlobalColor; por ejemplo, «green» y « Qt::green » no se refieren al mismo color.
  • transparent - Representa la ausencia de color.

Devuelve un color no válido si no se puede analizar name.

Esta función se introdujo en Qt 6.4.

Véase también isValidColorName().

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

Establece el contenido al que apuntan c, m, y, k y a como los componentes cian, magenta, amarillo, negro y del canal alfa (transparencia) del valor CMYK del color.

Estos componentes pueden recuperarse individualmente mediante las funciones cyan(), magenta(), yellow(), black() y alpha().

Véase también setCmyk() y The CMYK Color Model.

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

Establece el contenido al que apuntan c, m, y, k y a como los componentes cian, magenta, amarillo, negro y del canal alfa (transparencia) del valor CMYK del color.

Estos componentes se pueden obtener individualmente mediante las funciones cyanF(), magentaF(), yellowF(), blackF() y alphaF().

Véase también setCmykF() y The CMYK Color Model.

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

Establece el contenido al que apuntan h, s, l y a como los componentes de matiz, saturación, luminosidad y canal alfa (transparencia) del valor HSL del color.

Estos componentes pueden recuperarse individualmente mediante las funciones hslHue(), hslSaturation(), lightness() y alpha().

Véase también getHslF(), setHsl() y The HSL Color Model.

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

Establece el contenido al que apuntan h, s, l y a como los componentes de tono, saturación, luminosidad y canal alfa (transparencia) del valor HSL del color.

Estos componentes pueden recuperarse individualmente mediante las funciones hslHueF(), hslSaturationF(), lightnessF() y alphaF().

Véase también getHsl(), setHslF() y The HSL Color Model.

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

Establece el contenido al que apuntan h, s, v y a como los componentes de matiz, saturación, valor y canal alfa (transparencia) del valor HSV del color.

Estos componentes pueden recuperarse individualmente mediante las funciones hue(), saturation(), value() y alpha().

Véase también setHsv() y The HSV Color Model.

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

Establece el contenido al que apuntan h, s, v y a como los componentes de matiz, saturación, valor y canal alfa (transparencia) del valor HSV del color.

Estos componentes pueden recuperarse individualmente mediante las funciones hueF(), saturationF(), valueF() y alphaF().

Véase también setHsv() y The HSV Color Model.

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

Establece el contenido al que apuntan r, g, b y a como los componentes de rojo, verde, azul y del canal alfa (transparencia) del valor RGB del color.

Estos componentes se pueden obtener individualmente mediante las funciones red(), green(), blue() y alpha().

Véanse también rgb() y setRgb().

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

Establece el contenido al que apuntan r, g, b y a como los componentes de rojo, verde, azul y canal alfa (transparencia) del valor RGB del color.

Estos componentes se pueden obtener individualmente mediante las funciones redF(), greenF(), blueF() y alphaF().

Véanse también rgb() y setRgb().

[noexcept] int QColor::green() const

Devuelve el componente de color verde de este color.

Véase también setGreen(), greenF() y getRgb().

[noexcept] float QColor::greenF() const

Devuelve el componente de color verde de este color.

Véase también setGreenF(), green() y getRgbF().

[noexcept] int QColor::hslHue() const

Devuelve el componente de tono (HSL) de este color.

Véase también hslHueF(), hsvHue(), getHsl() y The HSL Color Model.

[noexcept] float QColor::hslHueF() const

Devuelve el componente de tono (HSL) de este color.

Véase también hslHue(), hsvHueF() y getHslF().

[noexcept] int QColor::hslSaturation() const

Devuelve el componente de saturación HSL de este color.

Véase también hslSaturationF(), hsvSaturation(), getHsl() y The HSL Color Model.

[noexcept] float QColor::hslSaturationF() const

Devuelve el componente de saturación HSL de este color.

Véase también hslSaturation(), hsvSaturationF(), getHslF() y The HSL Color Model.

[noexcept] int QColor::hsvHue() const

Devuelve el componente de tono (HSV) de este color.

Véase también hueF(), hslHue(), getHsv() y The HSV Color Model.

[noexcept] float QColor::hsvHueF() const

Devuelve el componente de matiz de este color.

Véase también hue(), hslHueF(), getHsvF() y The HSV Color Model.

[noexcept] int QColor::hsvSaturation() const

Devuelve el componente de saturación HSV de este color.

Véase también saturationF(), hslSaturation(), getHsv() y The HSV Color Model.

[noexcept] float QColor::hsvSaturationF() const

Devuelve el componente de saturación HSV de este color.

Véase también saturation(), hslSaturationF(), getHsvF() y The HSV Color Model.

[noexcept] int QColor::hue() const

Devuelve el componente de tono (HSV) de este color.

El color se convierte implícitamente a HSV.

Véase también hsvHue(), hslHue(), hueF(), getHsv() y The HSV Color Model.

[noexcept] float QColor::hueF() const

Devuelve el componente de tono (hue) del modelo HSV de este color.

El color se convierte implícitamente a HSV.

Véase también hsvHueF(), hslHueF(), hue(), getHsvF() y The HSV Color Model.

[noexcept] bool QColor::isValid() const

Devuelve « true » si el color es válido; en caso contrario, devuelve « false ».

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

Devuelve ` true ` si ` name ` es un nombre de color válido y puede utilizarse para crear un objeto ` QColor ` válido; en caso contrario, devuelve `false`.

Utiliza el mismo algoritmo que se emplea en fromString().

Esta función se introdujo en Qt 6.4.

Véase también fromString().

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

Devuelve un color más claro (o más oscuro), pero no modifica este objeto.

Si el valor de « factor » es superior a 100, esta función devuelve un color más claro. Al establecer « factor » en 150, se devuelve un color un 50 % más brillante. Si « factor » es inferior a 100, el color devuelto es más oscuro, pero recomendamos utilizar la función « darker()» para este fin. Si « factor » es 0 o un valor negativo, el valor devuelto no está especificado.

La función convierte el color actual a HSV, multiplica el componente de valor (V) por factor y vuelve a convertir el color a su especificación original.

Véanse también darker() y isValid().

[noexcept] int QColor::lightness() const

Devuelve el componente de claridad de este color.

Véase también lightnessF() y getHsl().

[noexcept] float QColor::lightnessF() const

Devuelve el componente de luminosidad de este color.

Véase también value() y getHslF().

[noexcept] int QColor::magenta() const

Devuelve el componente de color magenta de este color.

Véase también magentaF(), getCmyk() y The CMYK Color Model.

[noexcept] float QColor::magentaF() const

Devuelve el componente de color magenta de este color.

Véase también magenta(), getCmykF() y The CMYK Color Model.

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

Devuelve el nombre del color en el formato especificado format.

Véase también fromString() y NameFormat.

[noexcept] int QColor::red() const

Devuelve el componente de color rojo de este color.

Véase también setRed(), redF() y getRgb().

[noexcept] float QColor::redF() const

Devuelve el componente de color rojo de este color.

Véase también setRedF(), red() y getRgbF().

[noexcept] QRgb QColor::rgb() const

Devuelve el valor RGB del color. El valor alfa es opaco.

Véase también setRgb(), getRgb() y rgba().

[noexcept] QRgba64 QColor::rgba64() const

Devuelve el valor RGB64 del color, incluido su alfa.

En el caso de un color no válido, el valor alfa del color devuelto no está especificado.

Véase también setRgba64(), rgba() y rgb().

[noexcept] QRgb QColor::rgba() const

Devuelve el valor RGB del color, incluido su alfa.

En el caso de un color no válido, el valor alfa del color devuelto no está especificado.

Véase también setRgba(), rgb() y rgba64().

[noexcept] int QColor::saturation() const

Devuelve el componente de saturación HSV de este color.

El color se convierte implícitamente al espacio HSV.

Véase también hsvSaturation(), hslSaturation(), saturationF(), getHsv() y The HSV Color Model.

[noexcept] float QColor::saturationF() const

Devuelve el componente de saturación HSV de este color.

El color se convierte implícitamente a HSV.

Véase también hsvSaturationF(), hslSaturationF(), saturation(), getHsvF() y The HSV Color Model.

void QColor::setAlpha(int alpha)

Establece el alfa de este color en alpha. El alfa, de tipo entero, se especifica en el intervalo 0-255.

Véase también alpha(), alphaF() y Alpha-Blended Drawing.

void QColor::setAlphaF(float alpha)

Establece el alfa de este color en alpha. El valor de alfa (tipo float) se especifica en el intervalo 0,0-1,0.

Véase también alphaF(), alpha() y Alpha-Blended Drawing.

void QColor::setBlue(int blue)

Establece el componente de color azul de este color en blue. Los componentes enteros se especifican en el intervalo 0-255.

Véase también blue(), blueF() y setRgb().

void QColor::setBlueF(float blue)

Establece el componente de color azul de este color en blue. Si blue se encuentra fuera del rango 0,0-1,0, el modelo de color se cambiará a ExtendedRgb.

Véase también blueF(), blue() y setRgbF().

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

Establece el color con los valores CMYK: c (cian), m (magenta), y (amarillo), k (negro) y a (canal alfa, es decir, transparencia).

Todos los valores deben estar comprendidos entre 0 y 255.

Véase también getCmyk(), setCmykF() y The CMYK Color Model.

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

Establece el color en los valores CMYK: c (cian), m (magenta), y (amarillo), k (negro) y a (canal alfa, es decir, transparencia).

Todos los valores deben estar comprendidos entre 0,0 y 1,0.

Véase también getCmykF(), setCmyk() y The CMYK Color Model.

void QColor::setGreen(int green)

Establece el componente verde de este color en green. Los componentes enteros se especifican en el intervalo 0-255.

Véase también green(), greenF() y setRgb().

void QColor::setGreenF(float green)

Establece el componente de color verde de este color en green. Si green se encuentra fuera del intervalo 0,0-1,0, el modelo de color se cambiará a ExtendedRgb.

Véanse también greenF(), green() y setRgbF().

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

Establece un valor de color HSL; h es el matiz, s es la saturación, l es la luminosidad y a es el componente alfa del color HSL.

Los valores de saturación, valor y canal alfa deben estar comprendidos entre 0 y 255, y el valor de matiz debe ser superior a -1.

Véase también getHsl() y setHslF().

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

Establece la luminosidad de un color HSL; h es el matiz, s es la saturación, l es la luminosidad y a es el componente alfa del color HSL.

Todos los valores deben estar comprendidos entre 0,0 y 1,0.

Véase también getHslF() y setHsl().

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

Establece un valor de color HSV; h es el matiz, s es la saturación, v es el valor y a es el componente alfa del color HSV.

Los valores de saturación, valor y canal alfa deben estar comprendidos entre 0 y 255, y el valor de matiz debe ser mayor que -1.

Véase también getHsv(), setHsvF() y The HSV Color Model.

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

Establece un valor de color HSV; h es el matiz, s es la saturación, v es el valor y a es el componente alfa del color HSV.

Todos los valores deben estar comprendidos entre 0,0 y 1,0.

Véase también getHsvF(), setHsv() y The HSV Color Model.

void QColor::setRed(int red)

Establece el componente de color rojo de este color en red. Los componentes enteros se especifican en el intervalo 0-255.

Véase también red(), redF() y setRgb().

void QColor::setRedF(float red)

Establece el componente de color rojo de este color en red. Si red se encuentra fuera del intervalo 0,0-1,0, el modelo de color se cambiará a ExtendedRgb.

Véanse también redF(), red() y setRgbF().

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

Establece el valor RGB en r, g, b y el valor alfa en a.

Todos los valores deben estar comprendidos entre 0 y 255.

Véase también rgb(), getRgb() y setRgbF().

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

Establece el valor RGB en rgb. El valor alfa se establece en opaco.

Esta es una función sobrecargada.

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

Establece el valor RGB64 en rgba, incluyendo su canal alfa.

Véase también setRgba() y rgba64().

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

Establece los canales de color de este color en r (rojo), g (verde), b (azul) y a (alfa, transparencia).

El valor alfa debe estar comprendido entre 0,0 y 1,0. Si alguno de los demás valores se encuentra fuera del intervalo 0,0-1,0, el modelo de color se establecerá como ExtendedRgb.

Véase también rgb(), getRgbF() y setRgb().

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

Establece el valor RGB en rgba, incluyendo su canal alfa.

Véase también rgba(), rgb() y setRgba64().

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

Devuelve cómo se especificó el color.

Véase también Spec y convertTo().

[noexcept] QColor QColor::toCmyk() const

Crea y devuelve un objeto « QColor » en CMYK basado en este color.

Véase también fromCmyk(), convertTo(), isValid() y The CMYK Color Model.

[noexcept] QColor QColor::toExtendedRgb() const

Crea y devuelve un objeto « QColor » RGB ampliado basado en este color.

Véase también ` toRgb ` y ` convertTo()`.

[noexcept] QColor QColor::toHsl() const

Crea y devuelve un QColor HSL basado en este color.

Véase también fromHsl(), convertTo(), isValid() y The HSL Color Model.

[noexcept] QColor QColor::toHsv() const

Crea y devuelve un objeto HSV QColor basado en este color.

Véase también fromHsv(), convertTo(), isValid() y The HSV Color Model.

[noexcept] QColor QColor::toRgb() const

Crea y devuelve un objeto ` QColor ` en formato RGB basado en este color.

Véase también fromRgb(), convertTo() y isValid().

[noexcept] int QColor::value() const

Devuelve el componente de color de este color.

Véase también valueF(), getHsv() y The HSV Color Model.

[noexcept] float QColor::valueF() const

Devuelve el componente de color de este color.

Véase también value(), getHsvF() y The HSV Color Model.

[noexcept] int QColor::yellow() const

Devuelve el componente de color amarillo de este color.

Véase también yellowF(), getCmyk() y The CMYK Color Model.

[noexcept] float QColor::yellowF() const

Devuelve el componente de color amarillo de este color.

Véase también yellow(), getCmykF() y The CMYK Color Model.

QColor::operator QVariant() const

Devuelve el color como un QVariant

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

Devuelve ` true ` si este color tiene una especificación de color o unos valores de componentes diferentes a los de ` color`; en caso contrario, devuelve ` false`.

ExtendedRgb En este contexto, las especificaciones RGB se consideran coincidentes.

Véase también spec().

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

Asigna una copia de « color » y devuelve una referencia a este color.

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

Devuelve « true » si este color tiene la misma especificación de color y los mismos valores de componentes que « color »; en caso contrario, devuelve « false ».

ExtendedRgb En este contexto, se considera que las especificaciones Rgb coinciden.

Véase también spec().

Elementos no miembros relacionados

QRgb

Un cuádruple ARGB con el formato #AARRGGBB, equivalente a un entero sin signo.

Este tipo también contiene un valor para el canal alfa. El valor predeterminado del canal alfa es ff, es decir, opaco. Para obtener más información, consulta la sección « Alpha-Blended Drawing ».

A continuación se muestran algunos ejemplos de cómo se pueden crear valores QRgb:

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

Véanse también qRgb(), qRgba(), QColor::rgb() y QColor::rgba().

[constexpr] int qAlpha(QRgb rgba)

Devuelve el componente alfa del cuádruplete ARGB rgba.

Véase también qRgb() y QColor::alpha().

[constexpr] uint qAlpha(QRgba64 rgba64)

Devuelve el componente alfa de rgba64 como un valor de 8 bits.

Véase también QRgba64::alpha8() y QColor::alpha().

[constexpr] int qBlue(QRgb rgb)

Devuelve el componente azul del cuádruplete ARGB rgb.

Véase también qRgb() y QColor::blue().

[constexpr] uint qBlue(QRgba64 rgba64)

Devuelve el componente azul de rgba64 como un valor de 8 bits.

Véase también QRgba64::blue8() y QColor::blue().

[constexpr] int qGray(int r, int g, int b)

Devuelve un valor de gris (de 0 a 255) a partir del trío (r, g, b).

El valor de gris se calcula mediante la fórmula (r * 11 + g * 16 + b * 5)/32.

[constexpr] int qGray(QRgb rgb)

Devuelve un valor de gris (de 0 a 255) a partir del cuádruplet ARGB dado rgb.

El valor de gris se calcula mediante la fórmula (R * 11 + G * 16 + B * 5)/32; se ignora el canal alfa.

Se trata de una función sobrecargada.

[constexpr] int qGreen(QRgb rgb)

Devuelve el componente verde del cuádruplet ARGB rgb.

Véase también qRgb() y QColor::green().

[constexpr] uint qGreen(QRgba64 rgba64)

Devuelve el componente verde de rgba64 como un valor de 8 bits.

Véase también QRgba64::green8() y QColor::green().

[constexpr] QRgb qPremultiply(QRgb rgb)

Convierte un cuádruplet ARGB sin premultiplicar rgb en un cuádruplet ARGB premultiplicado.

Véase también qUnpremultiply().

[constexpr] QRgba64 qPremultiply(QRgba64 rgba64)

Convierte un cuádruplet QRgba64 sin premultiplicar rgba64 en un cuádruplet QRgba64 premultiplicado.

Véase también QRgba64::premultiplied() y qUnpremultiply().

[constexpr] int qRed(QRgb rgb)

Devuelve el componente rojo del cuádruplet ARGB rgb.

Véase también qRgb() y QColor::red().

[constexpr] uint qRed(QRgba64 rgba64)

Devuelve el componente rojo de rgba64 como un valor de 8 bits.

Véase también QRgba64::red8() y QColor::red().

[constexpr] QRgb qRgb(int r, int g, int b)

Devuelve el cuádruple ARGB (255, r, g, b).

Véase también qRgba(), qRed(), qGreen(), qBlue() y qAlpha().

[constexpr] QRgba64 qRgba64(quint64 c)

Devuelve « c » como una estructura « QRgba64 ».

Véase también qRgba().

[constexpr] QRgba64 qRgba64(quint16 r, quint16 g, quint16 b, quint16 a)

Devuelve el cuarteto « QRgba64 » (r, g, b, a).

Véase también qRgba().

[constexpr] QRgb qRgba(int r, int g, int b, int a)

Devuelve el cuádruplet ARGB (a, r, g, b).

Véase también qRgb(), qRed(), qGreen(), qBlue() y qAlpha().

QRgb qUnpremultiply(QRgb rgb)

Convierte un cuádruplet ARGB premultiplicado rgb en un cuádruplet ARGB no premultiplicado.

Véase también qPremultiply().

[constexpr] QRgba64 qUnpremultiply(QRgba64 rgba64)

Convierte un cuádruplet « QRgba64 » premultiplicado rgba64 en un cuádruplet « QRgba64 » no premultiplicado.

Véase también QRgba64::unpremultiplied() y qPremultiply().

QDataStream &operator<<(QDataStream &stream, const QColor &color)

Escribe el objeto ` color ` en el objeto ` stream`.

Véase también «Serialización detipos de datos de Qt».

QDataStream &operator>>(QDataStream &stream, QColor &color)

Lee el documento « color » (Guía de diseño de la interfaz de programación de aplicaciones de Qt) disponible en stream.

Véase también «Serialización detipos de datos de Qt».

© 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.