ColorConversionExtensions

Fornisce ColorConversionExtensions una serie di metodi di estensione che supportano la conversione, la modifica o l'ispezione Colordi s.

È ColorConversionExtensions possibile trovare sotto lo CommunityToolkit.Maui.Core.Extensions spazio dei nomi in modo da aggiungere semplicemente la riga seguente per iniziare:

using CommunityToolkit.Maui.Core.Extensions;

Converti colori

I metodi seguenti consentono di convertire .Color

ToBlackOrWhite

Il ToBlackOrWhite metodo converte l'oggetto in Color un valore monocromatico pari Colors.Black a o Colors.White.

Nell'esempio seguente viene illustrato come eseguire la conversione Colors.Red in un valore monocromatico:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToBlackOrWhite();

ToBlackOrWhiteForText

Il ToBlackOrWhiteForText metodo converte l'oggetto Color in un valore monocromatico di Colors.Black o Colors.White in base al fatto che l'oggetto Color sia determinato come scuro per l'occhio umano.

Nell'esempio seguente viene illustrato come eseguire la conversione Colors.Red in un valore monocromatico:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToBlackOrWhiteForText();

ToGrayScale

Il ToGrayScale metodo converte l'oggetto Color in una scala Colorgrigia.

L'esempio seguente illustra come convertire Colors.Red in un valore di scala grigia:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToGrayScale();

ToInverseColor

Il ToInverseColor metodo inverte l'oggetto Color.

Nell'esempio seguente viene illustrato come invertire Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToInverseColor();

Determinazione dell'oscurità dei colori

I metodi seguenti consentono di determinare se è Color considerato scuro.

IsDark

Metodo IsDark se è Color scuro.

L'esempio seguente illustra come determinare se Colors.Red è considerato scuro:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.IsDark();

IsDarkForTheEye

Metodo IsDarkForTheEye se l'oggetto Color è scuro per l'occhio umano.

L'esempio seguente mostra come determinare se Colors.Red è considerato scuro per l'occhio umano:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.IsDarkForTheEye();

Ottenere i componenti Color

I metodi seguenti consentono di ottenere uno dei componenti di Color.

GetByteRed

Il GetByteRed metodo ottiene il componente rosso di Color come valore compreso tra 0 e 255.

Nell'esempio seguente viene illustrato come ottenere il componente rosso di Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteRed();

GetByteGreen

Il GetByteGreen metodo ottiene il componente verde di Color come valore compreso tra 0 e 255.

Nell'esempio seguente viene illustrato come ottenere il componente verde di Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteGreen();

GetByteBlue

Il GetByteBlue metodo ottiene il componente blu di Color come valore compreso tra 0 e 255.

Nell'esempio seguente viene illustrato come ottenere il componente blu di Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteBlue();

GetDegreeHue

Il GetDegreeHue metodo ottiene il componente hue di Color come valore compreso tra 0 e 360.

L'esempio seguente illustra come ottenere il componente hue di Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetDegreeHue();

GetPercentCyan

Il GetPercentCyan metodo ottiene il componente ciano di Color come valore compreso tra 0 e 1.

L'esempio seguente illustra come ottenere il componente ciano di Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentCyan();

GetPercentMagenta

Il GetPercentMagenta metodo ottiene il componente magenta di Color come valore compreso tra 0 e 1.

L'esempio seguente illustra come ottenere il componente magenta di Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentMagenta();

GetPercentYellow

Il GetPercentYellow metodo ottiene il componente giallo di Color come valore compreso tra 0 e 1.

Nell'esempio seguente viene illustrato come ottenere il componente giallo di Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentYellow();

GetPercentBlackKey

Il GetPercentBlackKey metodo ottiene il componente chiave nera di Color come valore compreso tra 0 e 1.

Nell'esempio seguente viene illustrato come ottenere il componente chiave nera di Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentBlackKey();

GetByteAlpha

Il GetByteAlpha metodo ottiene il componente alfa di Color come valore compreso tra 0 e 255.

Nell'esempio seguente viene illustrato come ottenere il componente alfa di Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteAlpha();

Per colorare la stringa

I metodi seguenti consentono di convertire in Color una combinazione stringdi colori .

ToCmykaString

Il ToCmykaString metodo converte in Color un string oggetto contenente i componenti ciano, magenta, giallo e chiave. Il risultato string sarà nel formato: CMYKA(cyan,magenta,yellow,key,alpha) dove ciano, magenta, giallo e chiave sarà un valore compreso tra 0% e 100%, e alfa sarà un valore compreso tra 0 e 1 (ad esempioCMYKA(0%,100%,100%,0%,1), per Colors.Red).

Nell'esempio seguente viene illustrato come eseguire la conversione Colors.Red in una stringa CMYKA:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToCmykaString();

Dipende dalle impostazioni cultura, il valore alfa può avere un delimeter diverso:

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

Il ToCmykString metodo converte in Color un string oggetto contenente i componenti ciano, magenta, giallo e chiave. Il risultato string sarà nel formato: CMYK(cyan,magenta,yellow,key) dove ciano, magenta, giallo e chiave sarà un valore compreso tra 0% e 100% (ad esempio CMYK(0%,100%,100%,0%) per Colors.Red).

L'esempio seguente illustra come eseguire la conversione Colors.Red in una stringa CMYK:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToCmykString();

ToHslaString

Il ToHslaString metodo converte in Color un string oggetto contenente i componenti ciano, magenta, giallo e chiave. Il risultato string sarà nel formato: HSLA(hue,saturation,lightness,alpha) dove hue sarà un valore compreso tra 0 e 360, saturazione e saturazione sarà un valore compreso tra 0% e 100%, e alfa sarà un valore compreso tra 0 e 1 (ad esempioHSLA(0,100%,50%,1), per Colors.Red).

L'esempio seguente illustra come eseguire la conversione Colors.Red in una stringa HSLA:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToHslaString();

Dipende dalle impostazioni cultura, il valore alfa può avere un delimeter diverso:

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

Il ToHslString metodo converte in Color un string oggetto contenente i componenti ciano, magenta, giallo e chiave. Il risultato string sarà nel formato: HSL(hue,saturation,lightness) dove hue sarà un valore compreso tra 0 e 360, saturazione e saturazione sarà un valore compreso tra 0% e 100% (ad esempio HSL(0,100%,50%) per Colors.Red).

L'esempio seguente illustra come eseguire la conversione Colors.Red in una stringa HSL:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToHslString();

ToRgbaString

Il ToRgbaString metodo converte in Color un string oggetto contenente i componenti rosso, verde, blu e alfa. Il risultato string sarà nel formato: RGB(red,green,blue,alpha) dove rosso, verde e blu sarà un valore compreso tra 0 e 255 e alfa sarà un valore compreso tra 0 e 1 (ad esempioRGBA(255,0,0,1), per Colors.Red).

L'esempio seguente illustra come eseguire la conversione Colors.Red in una stringa RGBA:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToRgbaString();

Dipende dalle impostazioni cultura, il valore alfa può avere un delimeter diverso:

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

Il ToRgbString metodo converte l'oggetto in Color un string oggetto contenente i componenti rosso, verde e blu. Il risultato string sarà nel formato: RGB(red,green,blue) dove rosso, verde e blu sarà un valore compreso tra 0 e 255 (ad esempio RGB(255,0,0) per Colors.Red).

L'esempio seguente illustra come eseguire la conversione Colors.Red in una stringa RGB:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToRgbString();

Con i componenti Color

I metodi seguenti consentono di sostituire uno dei componenti di Color.

WithRed

Il WithRed metodo applica l'oggetto fornito redComponent all'oggetto Color. Si noti che redComponent può essere un double valore compreso tra 0 e 1 oppure un byte valore compreso tra 0 e 255.

Nell'esempio seguente viene illustrato come applicare il componente rosso a Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithRed(0.5);

WithGreen

Il WithGreen metodo applica l'oggetto fornito greenComponent all'oggetto Color. Si noti che greenComponent può essere un double valore compreso tra 0 e 1 oppure un byte valore compreso tra 0 e 255.

Nell'esempio seguente viene illustrato come applicare il componente verde a Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithGreen(0.5);

WithBlue

Il WithBlue metodo applica l'oggetto fornito blueComponent all'oggetto Color. Si noti che blueComponent può essere un double valore compreso tra 0 e 1 oppure un byte valore compreso tra 0 e 255.

Nell'esempio seguente viene illustrato come applicare il componente blu a Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithBlue(0.5);

WithCyan

Il WithCyan metodo applica l'oggetto fornito cyanComponent all'oggetto Color. Si noti che cyanComponent deve essere un valore compreso tra 0 e 1.

Nell'esempio seguente viene illustrato come applicare il componente ciano a Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithCyan(0.5);

WithMagenta

Il WithMagenta metodo applica l'oggetto fornito magentaComponent all'oggetto Color. Si noti che magentaComponent deve essere un valore compreso tra 0 e 1.

Nell'esempio seguente viene illustrato come applicare il componente magenta a Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithMagenta(0.5);

WithYellow

Il WithYellow metodo applica l'oggetto fornito yellowComponent all'oggetto Color. Si noti che yellowComponent deve essere un valore compreso tra 0 e 1.

Nell'esempio seguente viene illustrato come applicare il componente giallo a Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithYellow(0.5);

WithBlackKey

Il WithBlackKey metodo applica l'oggetto fornito blackKeyComponent all'oggetto Color. Si noti che blackKeyComponent deve essere un valore compreso tra 0 e 1.

Nell'esempio seguente viene illustrato come applicare il componente chiave nera a Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithBlackKey(0.5);

Esempi

È possibile trovare un esempio di questa estensione in azione nell'applicazione di esempio .NET MAUI Community Toolkit.

API

È possibile trovare il codice sorgente per ColorConversionExtensions over nel repository GitHub di .NET MAUI Community Toolkit.