En esta página

Color QML Type (Singleton)

Contiene funciones de utilidad relacionadas con los colores. Más...

Import Statement: import QtQuick
Since: Qt 6.12

Nota: Este tipo es un singleton de QML. Solo hay una instancia de este tipo en el motor de QML.

Métodos

  • color blend(color a, color b, real factor)
  • color darker(color baseColor, real factor)
  • bool equal(color lhs, color rhs)
  • color fromString(string name)
  • color hsla(real hue, real saturation, real lightness, real alpha)
  • color hsva(real hue, real saturation, real value, real alpha)
  • color lighter(color baseColor, real factor)
  • color rgba(real red, real green, real blue, real alpha)
  • color tint(color baseColor, color tintColor)
  • color transparent(color color, real opacity)

Descripción detallada

Documentación del método

color blend(color a, color b, real factor)

Devuelve un color que es una mezcla de a y b. El color resultante se construye a partir de las interpolaciones lineales independientes de los canales de color RGB de a y b.

Si factor es menor que 0,0, se devuelve a. Si factor es mayor que 1,0, se devuelve b.

color darker(color baseColor, real factor)

Devuelve un color más oscuro que baseColor en la proporción indicada en factor.

La función convierte el color RGB actual a HSV, divide el componente del valor (V) por el factor y vuelve a convertir el color a RGB.

Si el factor es mayor que 1,0, esta función devuelve un color más oscuro. Si se establece el factor en 3,0, se devuelve un color con un tercio del brillo. Si el factor es inferior a 1,0, el color devuelto es más claro, pero recomendamos utilizar la función Color::lighter() para este fin. Si el factor es 0 o negativo, el valor devuelto no está especificado.

bool equal(color lhs, color rhs)

Devuelve «true» si lhs y rhs son iguales. Véase operator==().

Nota: Esta función es una versión tipada de Qt::colorEqual().

color fromString(string name)

Devuelve el color correspondiente al « name » indicado (es decir, rojo o #ff0000). Si no existe dicho color, se lanza una excepción.

color hsla(real hue, real saturation, real lightness, real alpha)

Devuelve un color con los componentes especificados: hue, saturation, lightness y alpha. Todos los componentes deben estar comprendidos entre 0 y 1 (ambos inclusive).

color hsva(real hue, real saturation, real value, real alpha)

Devuelve un color con los componentes especificados hue, saturation, value y alpha. Todos los componentes deben estar comprendidos entre 0 y 1, ambos inclusive.

color lighter(color baseColor, real factor)

Devuelve un color más claro que baseColor en la proporción indicada en factor.

La función convierte el color RGB actual a HSV, multiplica el componente del valor (V) por el factor y vuelve a convertir el color a RGB.

Si el factor es mayor que 1,0, esta función devuelve un color más claro. Si se establece el factor en 1,5, devuelve un color un 50 % más brillante. Si el factor es inferior a 1,0, el color devuelto es más oscuro, pero recomendamos utilizar la función Color::darker() para este fin. Si el factor es 0 o negativo, el valor devuelto no está especificado.

color rgba(real red, real green, real blue, real alpha)

Devuelve un color con los componentes especificados red, green, blue y alpha. Todos los componentes deben estar comprendidos entre 0 y 1 (ambos inclusive).

color tint(color baseColor, color tintColor)

Esta función permite aplicar un matiz a un color (baseColor) con otro (tintColor).

El color de matiz suele ser mayoritariamente transparente; de lo contrario, no se podrá ver el color subyacente. El ejemplo siguiente proporciona un ligero matiz rojo al utilizar como color de matiz el rojo puro, que solo tiene una opacidad de 1/16.

Item {
    Rectangle {
        x: 0
        width: 80
        height: 80
        color: "lightsteelblue"
    }
    Rectangle {
        x: 100; width: 80; height: 80
        color: Color.tint("lightsteelblue", "#10FF0000")
    }
}

Representación en paralelo de un cuadrado de color azul acero claro y un cuadrado de color azul acero claro al que se le ha aplicado un matiz

El matiz resulta especialmente útil cuando se pretende transmitir un cambio sutil debido a algún evento; en ese caso, puedes utilizar el matiz para ajustar de forma más eficaz el color visible.

color transparent(color color, real opacity)

Devuelve un objeto « color » con un valor alfa de « opacity », que oscila entre 0 (totalmente transparente) y 1 (totalmente opaco).

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