Rozszerzenia ColorConversionExtensions

Udostępnia ColorConversionExtensions serię metod rozszerzeń, które obsługują konwertowanie, modyfikowanie lub inspekcję Colors.

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ą przekonwertowanie klasy 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 konwertuje Color wartość na wartość monochromatyczną Colors.Black lub Colors.White na podstawie tego, czy Color element jest określany jako ciemny dla ludzkiego oka.

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.

W poniższym przykładzie pokazano, jak odwrócić Colors.Redelement :

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToInverseColor();

Określanie ciemności koloru

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

IsDark

Metoda IsDark , jeśli jest ciemna Color .

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 Color jest ciemna 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();

Pobieranie składników kolorów

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

GetByteRed

Metoda GetByteRed pobiera czerwony składnik jako Color wartość z zakresu 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 zielony składnik jako Color 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 pobiera niebieski składnik jako Color 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 pobiera składnik hue jako Color 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 pobiera składnik magenta jako Color wartość z zakresu 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 pobiera żółty składnik jako Color wartość z zakresu od 0 do 1.

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

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentYellow();

GetPercentBlackKey

Metoda GetPercentBlackKey pobiera czarny składnik klucza jako Color wartość z zakresu od 0 do 1.

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

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentBlackKey();

GetByteAlpha

Metoda GetByteAlpha pobiera składnik alfa jako Color wartość z zakresu 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();

Do koloru ciąg

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. Wynik string będzie mieć format: CMYKA(cyan,magenta,yellow,key,alpha) gdzie cyan, magenta, żółty i klucz będzie wartością 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.Redwartości ).

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

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 konwertuje Color element na string zawierający składniki cyan, magenta, żółty i kluczowy. string Wynik będzie mieć format: CMYK(cyan,magenta,yellow,key) gdzie cyan, magenta, żółty i klucz będzie wartością z zakresu 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 konwertuje Color element na string zawierający składniki cyan, magenta, żółty i kluczowy. string Wynik będzie w formacie: HSLA(hue,saturation,lightness,alpha) gdzie odcienie będzie wartością z zakresu od 0 do 360, nasycenie i nasycenie będzie wartością z zakresu od 0% do 100%, a alfa będzie wartością z zakresu od 0 do 1 (np. HSLA(0,100%,50%,1) dla Colors.Redwartości ).

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 konwertuje Color element na string zawierający składniki cyan, magenta, żółty i kluczowy. string Wynik będzie mieć format: HSL(hue,saturation,lightness) gdzie odcienie będzie wartością z zakresu od 0 do 360, nasycenie i nasycenie będzie wartością z zakresu od 0% do 100% (np. HSL(0,100%,50%) dla Colors.Redwartości ).

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. string Wynik będzie mieć format: RGB(red,green,blue,alpha) gdzie czerwony, zielony i niebieski będzie wartością z zakresu od 0 do 255, a alfa będzie wartością z zakresu od 0 do 1 (np. RGBA(255,0,0,1) dla Colors.Redwartości ).

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. string Wynik będzie mieć format: RGB(red,green,blue) gdzie czerwony, zielony i niebieski będzie wartością z zakresu od 0 do 255 (np. RGB(255,0,0) dla Colors.Redwartości ).

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

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToRgbString();

Z składnikami color

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

WithRed

Metoda WithRed stosuje element dostarczony redComponent do klasy Color. Zwróć uwagę, że redComponent wartość może należeć double do zakresu od 0 do 1 lub byte od 0 do 255.

W poniższym przykładzie pokazano, jak zastosować czerwony składnik do Colors.Redelementu :

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithRed(0.5);

WithGreen

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

W poniższym przykładzie pokazano, jak zastosować zielony składnik do Colors.Redelementu :

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithGreen(0.5);

WithBlue

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

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

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.

W poniższym przykładzie pokazano, jak zastosować składnik cyjanu do Colors.Redelementu :

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithCyan(0.5);

WithMagenta

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

W poniższym przykładzie pokazano, jak zastosować składnik magenta do Colors.Redelementu :

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithMagenta(0.5);

WithYellow

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

W poniższym przykładzie pokazano, jak zastosować żółty składnik do Colors.Redelementu :

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithYellow(0.5);

WithBlackKey

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

W poniższym przykładzie pokazano, jak zastosować składnik czarnego klucza do Colors.Redelementu :

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithBlackKey(0.5);

Przykłady

Przykład tego rozszerzenia można znaleźć w aplikacji przykładowej zestawu narzędzi .NET MAUI Community Toolkit.

interfejs API

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