ColorConversionExtensions

ColorConversionExtensions fornece uma série de métodos de extensão para converter, modificar ou inspecionar Colors.

O ColorConversionExtensions pode ser encontrado no namespace CommunityToolkit.Maui.Core.Extensions, portanto, basta adicionar a seguinte linha para começar:

using CommunityToolkit.Maui.Core.Extensions;

Converter Cores

Os métodos a seguir permitem que você converta o Color.

ToBlackOrWhite

O método ToBlackOrWhite converte o valor de Color em um valor monocromático de Colors.Black ou Colors.White.

O exemplo a seguir mostra como converter Colors.Red em um valor monocromático:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToBlackOrWhite();

ToBlackOrWhiteForText

O método ToBlackOrWhiteForText converte o Color em um valor monocromático de Colors.Black ou Colors.White, com base em se o Color for considerado escuro pelo olho humano.

O exemplo a seguir mostra como converter Colors.Red em um valor monocromático:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToBlackOrWhiteForText();

ToGrayScale

O método ToGrayScale converte o(a) Color em uma Color em escala de cinza.

O exemplo a seguir mostra como converter Colors.Red em um valor de escala cinza:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToGrayScale();

ToInverseColor

O ToInverseColor método inverte o Color.

O exemplo a seguir mostra como inverter Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToInverseColor();

Determinando a escuridão da cor

Os métodos a seguir permitem que você determine se o Color é considerado escuro.

IsDark

O método IsDark se o Color estiver escuro.

O exemplo a seguir mostra como determinar se Colors.Red é considerado escuro:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.IsDark();

IsDarkForTheEye

O método IsDarkForTheEye indica se o Color está escuro ao olho humano.

O exemplo a seguir mostra como determinar se Colors.Red é considerado escuro para o olho humano:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.IsDarkForTheEye();

Obter componentes color

Os métodos a seguir permitem que você obtenha um dos componentes do Color.

GetByteRed

O método GetByteRed obtém o componente vermelho de Color como um valor entre 0 e 255.

O exemplo a seguir mostra como obter o componente vermelho de Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteRed();

GetByteGreen

O GetByteGreen método obtém o componente verde de Color como um valor entre 0 e 255.

O exemplo a seguir mostra como obter o componente verde de Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteGreen();

GetByteBlue

O método GetByteBlue obtém o componente azul de Color como um valor entre 0 e 255.

O exemplo a seguir mostra como obter o componente azul de Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteBlue();

GetDegreeHue

O GetDegreeHue método obtém o componente hue de Color como um valor entre 0 e 360.

O exemplo a seguir mostra como obter o componente hue de Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetDegreeHue();

GetPercentCyan

O método GetPercentCyan retorna o componente ciano de Color como um valor entre 0 e 1.

O exemplo a seguir mostra como obter o componente ciano de Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentCyan();

GetPercentMagenta

O método GetPercentMagenta obtém o componente magenta de Color como um valor entre 0 e 1.

O exemplo a seguir mostra como obter o componente magenta de Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentMagenta();

GetPercentYellow

O GetPercentYellow método obtém o componente amarelo de Color como um valor entre 0 e 1.

O exemplo a seguir mostra como obter o componente amarelo de Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentYellow();

GetPercentBlackKey

O método GetPercentBlackKey obtém o componente preto de Color como um valor entre 0 e 1.

O exemplo a seguir mostra como obter o componente de chave preta de Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentBlackKey();

GetByteAlpha

O método GetByteAlpha obtém o componente alfa de Color como um valor entre 0 e 255.

O exemplo a seguir mostra como obter o componente alfa de Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteAlpha();

Cadeia de caracteres To Color

Os métodos a seguir permitem converter o Color para um esquema de cores string.

ToCmykaString

ToCmykaString método converte o Color em um string contendo os componentes ciano, magenta, amarelo e preto. O resultado string será no formato: em que CMYKA(cyan,magenta,yellow,key,alpha)ciano, magenta, amarelo e chave serão um valor entre 0% e 100%, e alfa será um valor entre 0 e 1 (por exemplo, CMYKA(0%,100%,100%,0%,1) para Colors.Red).

O exemplo a seguir mostra como converter Colors.Red em uma cadeia de caracteres CMYKA:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToCmykaString();

Depende das configurações de cultura, o valor alfa pode ter delimeter diferente:

new Color(0, 0, 0, 0.5f).ToCmykaString(new System.Globalization.CultureInfo("en-US")); // returns "CMYKA(0%,0%,0%,100%,0.5)"
new Color(0, 0, 0, 0.5f).ToCmykaString(new System.Globalization.CultureInfo("uk-UA")); // returns "CMYKA(0%,0%,0%,100%,0,5)"

ToCmykString

O método ToCmykString converte o Color em um string que contém os componentes ciano, magenta, amarelo e preto. O resultado string será no formato: em que CMYK(cyan,magenta,yellow,key)ciano, magenta, amarelo e chave serão um valor entre 0% e 100% (por exemplo CMYK(0%,100%,100%,0%) , para Colors.Red).

O exemplo a seguir mostra como converter Colors.Red em uma cadeia de caracteres CMYK:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToCmykString();

ToHslaString

O método ToHslaString converte o Color em um string contendo os componentes ciano, magenta, amarelo e preto. O resultado string será no formato: HSLA(hue,saturation,lightness,alpha) onde matiz será um valor entre 0 e 360, saturação e saturação serão um valor entre 0% e 100%e alfa será um valor entre 0 e 1 (por exemplo, HSLA(0,100%,50%,1) para Colors.Red).

O exemplo a seguir mostra como converter Colors.Red em uma cadeia de caracteres HSLA:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToHslaString();

Depende das configurações de cultura, o valor alfa pode ter delimeter diferente:

new Color(0, 0, 0, 0.5f).ToHslaString(new System.Globalization.CultureInfo("en-US")); // returns "HSLA(0%,0%,0%,100%,0.5)"
new Color(0, 0, 0, 0.5f).ToHslaString(new System.Globalization.CultureInfo("uk-UA")); // returns "HSLA(0%,0%,0%,100%,0,5)"

ToHslString

O método ToHslString converte o Color em um string que contém os componentes ciano, magenta, amarelo e preto. O string resultante estará no formato: HSL(hue,saturation,lightness), em que matiz será um valor entre 0 e 360, e saturação e saturação serão valores entre 0% e 100% (por exemplo, HSL(0,100%,50%) para Colors.Red).

O exemplo a seguir mostra como converter Colors.Red em uma cadeia de caracteres HSL:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToHslString();

ToRgbaString

O método ToRgbaString converte o Color em um string contendo os componentes vermelho, verde, azul e alfa. O resultado string será no formato: RGB(red,green,blue,alpha) em que vermelho, verde e azul será um valor entre 0 e 255, e alfa será um valor entre 0 e 1 (por exemplo RGBA(255,0,0,1) , para Colors.Red).

O exemplo a seguir mostra como converter Colors.Red em uma cadeia de caracteres RGBA:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToRgbaString();

Depende das configurações de cultura, o valor alfa pode ter delimeter diferente:

new Color(0, 0, 0, 0.5f).ToRgbaString(new System.Globalization.CultureInfo("en-US")); // returns "RGBA(0,0,0,0.5)"
new Color(0, 0, 0, 0.5f).ToRgbaString(new System.Globalization.CultureInfo("uk-UA")); // returns "RGBA(0,0,0,0,5)"

ToRgbString

O método ToRgbString converte o Color em um string que contém os componentes vermelho, verde e azul. O resultado string será no formato: RGB(red,green,blue) em que vermelho, verde e azul será um valor entre 0 e 255 (por exemplo, RGB(255,0,0) para Colors.Red).

O exemplo a seguir mostra como converter Colors.Red em uma cadeia de caracteres RGB:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToRgbString();

Com componentes de cor

Os métodos a seguir permitem substituir um dos componentes do Color.

WithRed

O WithRed método aplica o fornecido redComponent ao Color. Observe que redComponent pode ser entre double 0 e 1 ou byte entre 0 e 255.

O exemplo a seguir mostra como aplicar o componente vermelho a Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithRed(0.5);

WithGreen

O WithGreen método aplica o fornecido greenComponent ao Color. Observe que greenComponent pode ser entre double 0 e 1 ou byte entre 0 e 255.

O exemplo a seguir mostra como aplicar o componente verde a Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithGreen(0.5);

WithBlue

O WithBlue método aplica o fornecido blueComponent ao Color. Observe que blueComponent pode ser entre double 0 e 1 ou byte entre 0 e 255.

O exemplo a seguir mostra como aplicar o componente azul a Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithBlue(0.5);

WithCyan

O WithCyan método aplica o fornecido cyanComponent ao Color. Observe que deve cyanComponent ser um valor entre 0 e 1.

O exemplo a seguir mostra como aplicar o componente ciano a Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithCyan(0.5);

WithMagenta

O WithMagenta método aplica o fornecido magentaComponent ao Color. Observe que deve magentaComponent ser um valor entre 0 e 1.

O exemplo a seguir mostra como aplicar o componente magenta a Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithMagenta(0.5);

WithYellow

O WithYellow método aplica o fornecido yellowComponent ao Color. Observe que deve yellowComponent ser um valor entre 0 e 1.

O exemplo a seguir mostra como aplicar o componente amarelo a Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithYellow(0.5);

WithBlackKey

O WithBlackKey método aplica o fornecido blackKeyComponent ao Color. Observe que deve blackKeyComponent ser um valor entre 0 e 1.

O exemplo a seguir mostra como aplicar o componente de chave preta a Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithBlackKey(0.5);

Exemplos

Você pode encontrar um exemplo dessa extensão em ação no aplicativo de exemplo .NET MAUI Community Toolkit.

API

O código-fonte do ColorConversionExtensions pode ser encontrado no repositório GitHub do .NET MAUI Community Toolkit.