ColorConversionExtensions

Ange ColorConversionExtensions en serie tilläggsmetoder som stöder konvertering, ändring eller inspektion Colorav s.

Finns ColorConversionExtensions under CommunityToolkit.Maui.Core.Extensions namnområdet så lägg bara till följande rad för att komma igång:

using CommunityToolkit.Maui.Core.Extensions;

Konvertera färger

Med följande metoder kan du konvertera Color.

ToBlackOrWhite

Metoden ToBlackOrWhite konverterar Color till ett monokromt värde för Colors.Black eller Colors.White.

I följande exempel visas hur du konverterar Colors.Red till ett monokromt värde:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToBlackOrWhite();

ToBlackOrWhiteForText

Metoden ToBlackOrWhiteForText konverterar Color till ett monokromt värde av Colors.Black eller Colors.White baserat på om Color bestäms vara mörk för det mänskliga ögat.

I följande exempel visas hur du konverterar Colors.Red till ett monokromt värde:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToBlackOrWhiteForText();

ToGrayScale

Metoden ToGrayScale konverterar Color till en grå skala Color.

I följande exempel visas hur du konverterar Colors.Red till ett grått skalningsvärde:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToGrayScale();

ToInverseColor

Metoden ToInverseColor inverteras Color.

I följande exempel visas hur du invertera Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToInverseColor();

Fastställa färgmörker

Med följande metoder kan du avgöra om det Color anses vara mörkt.

IsDark

Metoden IsDark om är Color mörk.

I följande exempel visas hur du avgör om Colors.Red det anses vara mörkt:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.IsDark();

IsDarkForTheEye

Metoden IsDarkForTheEye om är Color mörk för det mänskliga ögat.

I följande exempel visas hur du avgör om Colors.Red det anses vara mörkt för det mänskliga ögat:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.IsDarkForTheEye();

Hämta färgkomponenter

Med följande metoder kan du hämta en av komponenterna i Color.

GetByteRed

Metoden GetByteRed hämtar den röda komponenten i Color som ett värde mellan 0 och 255.

I följande exempel visas hur du hämtar den röda komponenten i Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteRed();

GetByteGreen

Metoden GetByteGreen hämtar den gröna komponenten för Color som ett värde mellan 0 och 255.

I följande exempel visas hur du hämtar den gröna komponenten i Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteGreen();

GetByteBlue

Metoden GetByteBlue hämtar den blå komponenten Color i som ett värde mellan 0 och 255.

I följande exempel visas hur du hämtar den blå komponenten i Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteBlue();

GetDegreeHue

Metoden GetDegreeHue hämtar hue-komponentenColor för som ett värde mellan 0 och 360.

I följande exempel visas hur du hämtar hue-komponenten Colors.Redi :

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetDegreeHue();

GetPercentCyan

Metoden GetPercentCyan hämtar cyankomponentenColor som ett värde mellan 0 och 1.

I följande exempel visas hur du hämtar cyankomponenten Colors.Redi :

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentCyan();

GetPercentMagenta

Metoden GetPercentMagenta hämtar magenta-komponentenColor för som ett värde mellan 0 och 1.

I följande exempel visas hur du hämtar magenta-komponenten i Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentMagenta();

GetPercentYellow

Metoden GetPercentYellow hämtar den gula komponenten Color i som ett värde mellan 0 och 1.

I följande exempel visas hur du hämtar den gula komponenten i Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentYellow();

GetPercentBlackKey

Metoden GetPercentBlackKey hämtar den svarta nyckelkomponentenColor i som ett värde mellan 0 och 1.

I följande exempel visas hur du hämtar den svarta nyckelkomponenten i Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentBlackKey();

GetByteAlpha

Metoden GetByteAlpha hämtar alfakomponentenColor för som ett värde mellan 0 och 255.

I följande exempel visas hur du hämtar alfakomponenten Colors.Redi :

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteAlpha();

Till färgsträng

Med följande metoder kan du konvertera Color till ett färgschema string.

ToCmykaString

Metoden ToCmykaString konverterar Color till en string som innehåller komponenterna cyan, magenta, yellow och key. string Resultatet kommer att vara i formatet: CMYKA(cyan,magenta,yellow,key,alpha) där cyan, magenta, gul och nyckel kommer att vara ett värde mellan 0% och 100%, och alfa kommer att vara ett värde mellan 0 och 1 (t.ex. CMYKA(0%,100%,100%,0%,1) för Colors.Red).

I följande exempel visas hur du konverterar Colors.Red till en CMYKA-sträng:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToCmykaString();

Beroende på kulturinställningarna kan alfavärdet ha olika delimeter:

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

Metoden ToCmykString konverterar Color till en string som innehåller komponenterna cyan, magenta, yellow och key. string Resultatet kommer att vara i formatet: CMYK(cyan,magenta,yellow,key) där cyan, magenta, gul och nyckel kommer att vara ett värde mellan 0% och 100% (t.ex. CMYK(0%,100%,100%,0%) för Colors.Red).

I följande exempel visas hur du konverterar Colors.Red till en CMYK-sträng:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToCmykString();

ToHslaString

Metoden ToHslaString konverterar Color till en string som innehåller komponenterna cyan, magenta, yellow och key. string Resultatet kommer att vara i formatet: HSLA(hue,saturation,lightness,alpha) där hue kommer att vara ett värde mellan 0 och 360, mättnad och mättnad kommer att vara ett värde mellan 0% och 100%, och alfa kommer att vara ett värde mellan 0 och 1 (t.ex. HSLA(0,100%,50%,1) för Colors.Red).

I följande exempel visas hur du konverterar Colors.Red till en HSLA-sträng:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToHslaString();

Beroende på kulturinställningarna kan alfavärdet ha olika delimeter:

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

Metoden ToHslString konverterar Color till en string som innehåller komponenterna cyan, magenta, yellow och key. string Resultatet kommer att vara i formatet: HSL(hue,saturation,lightness) där hue kommer att vara ett värde mellan 0 och 360, mättnad och mättnad kommer att vara ett värde mellan 0% och 100% (t.ex. HSL(0,100%,50%) för Colors.Red).

I följande exempel visas hur du konverterar Colors.Red till en HSL-sträng:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToHslString();

ToRgbaString

Metoden ToRgbaString konverterar Color till en string som innehåller komponenterna röd, grön, blå och alfa. string Resultatet kommer att vara i formatet: RGB(red,green,blue,alpha) där rött, grönt och blått kommer att vara ett värde mellan 0 och 255, och alfa kommer att vara ett värde mellan 0 och 1 (t.ex. RGBA(255,0,0,1) för Colors.Red).

I följande exempel visas hur du konverterar Colors.Red till en RGBA-sträng:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToRgbaString();

Beroende på kulturinställningarna kan alfavärdet ha olika delimeter:

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

Metoden ToRgbString konverterar Color till en string som innehåller de röda, gröna och blå komponenterna. string Resultatet kommer att vara i formatet: RGB(red,green,blue) där rött, grönt och blått kommer att vara ett värde mellan 0 och 255 (t.ex. RGB(255,0,0) för Colors.Red).

I följande exempel visas hur du konverterar Colors.Red till en RGB-sträng:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToRgbString();

Med Color-komponenter

Med följande metoder kan du ersätta en av komponenterna i Color.

WithRed

Metoden WithRed tillämpar den angivna redComponent på Color. Observera att redComponent kan vara double mellan 0 och 1, eller byte mellan 0 och 255.

I följande exempel visas hur du tillämpar den röda komponenten på Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithRed(0.5);

WithGreen

Metoden WithGreen tillämpar den angivna greenComponent på Color. Observera att greenComponent kan vara double mellan 0 och 1, eller byte mellan 0 och 255.

I följande exempel visas hur du tillämpar den gröna komponenten på Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithGreen(0.5);

WithBlue

Metoden WithBlue tillämpar den angivna blueComponent på Color. Observera att blueComponent kan vara double mellan 0 och 1, eller byte mellan 0 och 255.

I följande exempel visas hur du tillämpar den blå komponenten på Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithBlue(0.5);

WithCyan

Metoden WithCyan tillämpar den angivna cyanComponent på Color. Observera att cyanComponent måste vara ett värde mellan 0 och 1.

I följande exempel visas hur du tillämpar cyankomponenten på Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithCyan(0.5);

WithMagenta

Metoden WithMagenta tillämpar den angivna magentaComponent på Color. Observera att magentaComponent måste vara ett värde mellan 0 och 1.

I följande exempel visas hur du tillämpar magenta-komponenten på Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithMagenta(0.5);

WithYellow

Metoden WithYellow tillämpar den angivna yellowComponent på Color. Observera att yellowComponent måste vara ett värde mellan 0 och 1.

I följande exempel visas hur du använder den gula komponenten på Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithYellow(0.5);

WithBlackKey

Metoden WithBlackKey tillämpar den angivna blackKeyComponent på Color. Observera att blackKeyComponent måste vara ett värde mellan 0 och 1.

I följande exempel visas hur du använder den svarta nyckelkomponenten på Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithBlackKey(0.5);

Exempel

Du hittar ett exempel på det här tillägget i praktiken i .NET MAUI Community Toolkit Sample Application.

API

Källkoden för ColorConversionExtensions finns på lagringsplatsen .NET MAUI Community Toolkit GitHub.