ColorConversionExtensions

Elementy ColorConversionExtensions udostępniają zestaw metod rozszerzających, które umożliwiają konwertowanie, modyfikowanie i sprawdzanie obiektów Color.

Element ColorConversionExtensions można znaleźć w obszarze CommunityToolkit.Maui.Core.Extensions przestrzeni nazw, więc wystarczy dodać następujący wiersz, aby rozpocząć pracę:

using CommunityToolkit.Maui.Core.Extensions;

Konwertowanie kolorów

Poniższe metody umożliwiają konwersję elementu Color.

ToBlackOrWhite

Metoda ToBlackOrWhite konwertuje Color wartość na wartość monochromatyczną Colors.Black lub Colors.White.

W poniższym przykładzie pokazano, jak przekonwertować Colors.Red na wartość monochromatyczną:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToBlackOrWhite();

ToBlackOrWhiteForText

Metoda ToBlackOrWhiteForText przekształca wartość Color na monochromatyczną wartość Colors.Black lub Colors.White w zależności od tego, czy element Color zostanie uznany za ciemny przez ludzkie oko.

W poniższym przykładzie pokazano, jak przekonwertować Colors.Red na wartość monochromatyczną:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToBlackOrWhiteForText();

ToGrayScale

Metoda ToGrayScale konwertuje Color element na szarą skalę Color.

W poniższym przykładzie pokazano, jak przekonwertować Colors.Red na szarą wartość skali:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToGrayScale();

ToInverseColor

Metoda ToInverseColor odwraca metodę Color.

Poniższy przykład pokazuje, jak odwrócić Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToInverseColor();

Określanie stopnia ciemności koloru

Poniższe metody umożliwiają określenie, czy Color element jest uznawany za ciemny.

IsDark

Metoda IsDark, jeśli Color jest ciemny.

W poniższym przykładzie pokazano, jak określić, czy Colors.Red jest uznawane za ciemne:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.IsDark();

IsDarkForTheEye

Metoda IsDarkForTheEye, jeśli element Color jest ciemny dla ludzkiego oka.

W poniższym przykładzie pokazano, jak określić, czy Colors.Red jest uważany za ciemny dla ludzkiego oka:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.IsDarkForTheEye();

Pobierz składowe koloru

Poniższe metody umożliwiają uzyskanie jednego ze składników klasy Color.

GetByteRed

Metoda GetByteRed pobiera czerwony składnik obiektu Color jako wartość z przedziału od 0 do 255.

W poniższym przykładzie pokazano, jak uzyskać czerwony składnik :Colors.Red

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteRed();

GetByteGreen

Metoda GetByteGreen pobiera składową zieloną elementu Color jako wartość z zakresu od 0 do 255.

W poniższym przykładzie pokazano, jak uzyskać zielony składnik programu Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteGreen();

GetByteBlue

Metoda GetByteBlue zwraca składową niebieską obiektu Color jako wartość z zakresu od 0 do 255.

W poniższym przykładzie pokazano, jak uzyskać niebieski składnik elementu Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteBlue();

GetDegreeHue

Metoda GetDegreeHue zwraca składnik odcień obiektu Color jako wartość z zakresu od 0 do 360.

W poniższym przykładzie pokazano, jak uzyskać składnik hue elementu Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetDegreeHue();

GetPercentCyan

Metoda GetPercentCyan pobiera składnik cyjanuColor jako wartość z zakresu od 0 do 1.

W poniższym przykładzie pokazano, jak uzyskać składnik cyjanu :Colors.Red

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentCyan();

GetPercentMagenta

Metoda GetPercentMagenta zwraca składową magenta obiektu Color jako wartość z przedziału od 0 do 1.

W poniższym przykładzie pokazano, jak pobrać składnik magenta elementu Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentMagenta();

GetPercentYellow

Metoda GetPercentYellow zwraca żółty składnik obiektu Color jako wartość z zakresu od 0 do 1.

Poniższy przykład pokazuje, jak uzyskać składową koloru żółtego z Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentYellow();

GetPercentBlackKey

Metoda GetPercentBlackKey zwraca składnik czerni elementu Color jako wartość z zakresu od 0 do 1.

W poniższym przykładzie pokazano, jak uzyskać składnik black key z Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentBlackKey();

GetByteAlpha

Metoda GetByteAlpha pobiera składową alfa obiektu Color jako wartość z przedziału od 0 do 255.

W poniższym przykładzie pokazano, jak uzyskać składnik alfa elementu Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteAlpha();

Na ciąg koloru

Poniższe metody umożliwiają przekonwertowanie Color elementu na schemat stringkolorów .

ToCmykaString

Metoda ToCmykaString konwertuje Color element na string zawierający składniki cyan, magenta, żółty i kluczowy. Powstały string będzie w formacie: CMYKA(cyan,magenta,yellow,key,alpha), gdzie cyjan, magenta, żółty i czarny będą wartościami z zakresu od 0% do 100%, a alfa będzie wartością z zakresu od 0 do 1 (np. CMYKA(0%,100%,100%,0%,1) dla Colors.Red).

Poniższy przykład pokazuje, jak przekształcić Colors.Red w ciąg CMYKA:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToCmykaString();

Zależy od ustawień kultury, wartość alfa może mieć inny ogranicznik:

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

Metoda ToCmykString przekształca Color w string zawierający składowe: cyjan, magenta, żółć i czerń. Otrzymany string będzie w formacie: CMYK(cyan,magenta,yellow,key), gdzie cyjan, magenta, żółty i czarny będą wartościami z przedziału od 0% do 100% (np. CMYK(0%,100%,100%,0%) dla Colors.Red).

W poniższym przykładzie pokazano, jak przekonwertować Colors.Red na ciąg CMYK:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToCmykString();

ToHslaString

Metoda ToHslaString przekształca Color na string zawierający składowe: cyjan, magenta, żółtą i czarną. Wynikowy string będzie mieć format: HSLA(hue,saturation,lightness,alpha), gdzie odcień będzie wartością od 0 do 360, nasycenie i nasycenie będą wartościami od 0% do 100%, a alfa będzie wartością od 0 do 1 (np. HSLA(0,100%,50%,1) dla Colors.Red).

Poniższy przykład przedstawia sposób konwertowania Colors.Red na ciąg HSLA:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToHslaString();

Zależy od ustawień kultury, wartość alfa może mieć inny ogranicznik:

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

Metoda ToHslString przekształca Color w string zawierający składowe: cyjan, magenta, żółtą i czarną. Wynikowe string będzie w formacie: HSL(hue,saturation,lightness), gdzie odcień będzie wartością z zakresu od 0 do 360, a nasycenie i nasycenie będą wartościami z zakresu od 0% do 100% (np. HSL(0,100%,50%) dla Colors.Red).

Poniższy przykład przedstawia sposób konwertowania Colors.Red na ciąg HSL:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToHslString();

ToRgbaString

Metoda ToRgbaString konwertuje Color element na zawierający string składniki czerwone, zielone, niebieskie i alfa. Wynikowy string będzie miał format: RGB(red,green,blue,alpha), gdzie czerwony, zielony i niebieski przyjmują wartości od 0 do 255, a alfa przyjmuje wartość od 0 do 1 (np. RGBA(255,0,0,1) dla Colors.Red).

W poniższym przykładzie pokazano, jak przekonwertować Colors.Red na ciąg RGBA:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToRgbaString();

Zależy od ustawień kultury, wartość alfa może mieć inny ogranicznik:

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

Metoda ToRgbString konwertuje Color element na zawierający string czerwone, zielone i niebieskie składniki. Wynikowy string będzie w formacie: RGB(red,green,blue), gdzie czerwony, zielony i niebieski będą wartościami od 0 do 255 (np. RGB(255,0,0) dla Colors.Red).

W poniższym przykładzie pokazano sposób konwertowania Colors.Red na ciąg RGB:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToRgbString();

Z komponentami kolorów

Poniższe metody umożliwiają zastąpienie jednego ze składników klasy Color.

WithRed

Metoda WithRed stosuje przekazany element redComponent do Color. Zwróć uwagę, że redComponent może być double między 0 a 1 albo byte między 0 a 255.

W poniższym przykładzie pokazano, jak zastosować składową czerwoną do Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithRed(0.5);

WithGreen

Metoda WithGreen stosuje element dostarczony greenComponent do klasy Color. Zwróć uwagę, że greenComponent może być double z zakresu od 0 do 1 lub byte z zakresu od 0 do 255.

W poniższym przykładzie pokazano, jak zastosować zielony komponent do elementu Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithGreen(0.5);

WithBlue

Metoda WithBlue stosuje element dostarczony blueComponent do klasy Color. Zwróć uwagę, że blueComponent może być double z zakresu od 0 do 1 lub byte z zakresu od 0 do 255.

W poniższym przykładzie pokazano, jak zastosować składnik niebieski do elementu Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithBlue(0.5);

WithCyan

Metoda WithCyan stosuje element dostarczony cyanComponent do klasy Color. Zwróć uwagę, że cyanComponent wartość musi być wartością z zakresu od 0 do 1.

Poniższy przykład pokazuje, jak zastosować składową cyjanową do elementu Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithCyan(0.5);

WithMagenta

Metoda WithMagenta stosuje przekazany element magentaComponent do klasy Color. Zwróć uwagę, że magentaComponent wartość musi być wartością z zakresu od 0 do 1.

Poniższy przykład pokazuje, jak zastosować składową magenta do elementu Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithMagenta(0.5);

WithYellow

Metoda WithYellow stosuje przekazany element yellowComponent do Color. Zwróć uwagę, że yellowComponent wartość musi być wartością z zakresu od 0 do 1.

Poniższy przykład pokazuje, jak zastosować żółty komponent do elementu Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithYellow(0.5);

WithBlackKey

Metoda WithBlackKey stosuje podany parametr blackKeyComponent do Color. Zwróć uwagę, że blackKeyComponent wartość musi być wartością z zakresu od 0 do 1.

Poniższy przykład pokazuje, jak zastosować komponent czarnego klawisza do elementu Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithBlackKey(0.5);

Examples

Przykład działania tego rozszerzenia można znaleźć w aplikacji przykładowej .NET MAUI Community Toolkit Sample Application.

API

Kod źródłowy ColorConversionExtensions można znaleźć w repozytorium .NET MAUI Community Toolkit GitHub.