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.
.NET MAUI Community Toolkit