ColorConversionExtensions

Les ColorConversionExtensions fournissent une série de méthodes d’extension permettant de convertir, de modifier ou d’inspecter des Colors.

Le ColorConversionExtensions se trouve dans l’espace de noms CommunityToolkit.Maui.Core.Extensions ; il vous suffit donc d’ajouter la ligne suivante pour démarrer :

using CommunityToolkit.Maui.Core.Extensions;

Convertir des couleurs

Les méthodes suivantes vous permettent de convertir le Color.

ToBlackOrWhite

La ToBlackOrWhite méthode convertit le Color en valeur monochrome de Colors.Black ou Colors.White.

L’exemple suivant montre comment effectuer une conversion Colors.Red en valeur monochrome :

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToBlackOrWhite();

ToBlackOrWhiteForText

La méthode ToBlackOrWhiteForText convertit le Color en une valeur monochrome de Colors.Black ou Colors.White selon que le Color est considéré comme sombre pour l’œil humain.

L’exemple suivant montre comment effectuer une conversion Colors.Red en valeur monochrome :

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToBlackOrWhiteForText();

ToGrayScale

La méthode ToGrayScale convertit Color en Color niveaux de gris.

L’exemple suivant montre comment convertir Colors.Red en valeur d’échelle grise :

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToGrayScale();

ToInverseColor

La ToInverseColor méthode inverse le Color.

L’exemple suivant montre comment inverser Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToInverseColor();

Détermination de l’obscurité des couleurs

Les méthodes suivantes vous permettent de déterminer si l’élément Color est considéré comme sombre.

IsDark

La méthode IsDark si le/la Color est sombre.

L’exemple suivant montre comment déterminer s’il Colors.Red est considéré comme sombre :

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.IsDark();

IsDarkForTheEye

La méthode IsDarkForTheEye si le Color est sombre pour l’œil humain.

L’exemple suivant montre comment déterminer si Colors.Red est considéré comme sombre par l’œil humain :

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.IsDarkForTheEye();

Récupérer les composants Color

Les méthodes suivantes vous permettent d’obtenir l’un des composants du Color.

GetByteRed

La GetByteRed méthode obtient le composant rouge de Color la valeur comprise entre 0 et 255.

L’exemple suivant montre comment obtenir le composant rouge de Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteRed();

GetByteGreen

La GetByteGreen méthode obtient le composant vert de Color la valeur comprise entre 0 et 255.

L’exemple suivant montre comment obtenir le composant vert de Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteGreen();

GetByteBlue

La GetByteBlue méthode obtient le composant bleu de Color la valeur comprise entre 0 et 255.

L’exemple suivant montre comment obtenir le composant bleu de Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteBlue();

GetDegreeHue

La GetDegreeHue méthode obtient le composant hue de Color la valeur comprise entre 0 et 360.

L’exemple suivant montre comment obtenir le composant hue de Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetDegreeHue();

GetPercentCyan

La méthode GetPercentCyan renvoie la composante cyan de Color sous la forme d’une valeur comprise entre 0 et 1.

L’exemple suivant montre comment obtenir le composant cyan de Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentCyan();

GetPercentMagenta

La GetPercentMagenta méthode obtient le composant magenta de Color la valeur comprise entre 0 et 1.

L’exemple suivant montre comment obtenir le composant magenta de Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentMagenta();

GetPercentYellow

La GetPercentYellow méthode obtient le composant jaune de Color la valeur comprise entre 0 et 1.

L’exemple suivant montre comment obtenir le composant jaune de Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentYellow();

GetPercentBlackKey

La GetPercentBlackKey méthode obtient le composant clé noire d’une Color valeur comprise entre 0 et 1.

L’exemple suivant montre comment obtenir le composant clé noire de Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentBlackKey();

GetByteAlpha

La GetByteAlpha méthode obtient le composant alpha de Color la valeur comprise entre 0 et 255.

L’exemple suivant montre comment obtenir le composant alpha de Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteAlpha();

Vers la chaîne de couleur

Les méthodes suivantes vous permettent de convertir le Color en schéma de couleurs string.

ToCmykaString

La méthode ToCmykaString convertit le Color en string contenant les composantes cyan, magenta, jaune et noir. Le résultat string sera au format : CMYKA(cyan,magenta,yellow,key,alpha) où cyan, magenta, jaune et clé seront une valeur comprise entre 0% et 100%, et alpha sera une valeur comprise entre 0 et 1 (par exemple CMYKA(0%,100%,100%,0%,1) pour Colors.Red).

L’exemple suivant montre comment effectuer une conversion Colors.Red en chaîne CMYKA :

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToCmykaString();

Dépend des paramètres de culture, la valeur alpha peut avoir différents délimètres :

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

La méthode ToCmykString convertit le Color en string contenant les composants cyan, magenta, jaune et noir. Le résultat string sera au format : CMYK(cyan,magenta,yellow,key) où cyan, magenta, jaune et clé seront une valeur comprise entre 0% et 100% (par exemple CMYK(0%,100%,100%,0%) pour Colors.Red).

L’exemple suivant montre comment convertir Colors.Red en chaîne CMYK :

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToCmykString();

ToHslaString

La méthode ToHslaString convertit le Color en un string contenant les composantes cyan, magenta, jaune et noir. Le résultat string sera au format : HSLA(hue,saturation,lightness,alpha) où la teinte sera une valeur comprise entre 0 et 360, la saturation et la saturation seront une valeur comprise entre 0% et 100%, et alpha sera une valeur comprise entre 0 et 1 (par exemple HSLA(0,100%,50%,1) pour Colors.Red).

L’exemple suivant montre comment convertir Colors.Red en chaîne HSLA :

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToHslaString();

Dépend des paramètres de culture, la valeur alpha peut avoir différents délimètres :

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

La méthode ToHslString convertit le Color en string contenant les composantes cyan, magenta, jaune et noir. Le résultat string sera au format : HSL(hue,saturation,lightness) où la teinte sera une valeur comprise entre 0 et 360, la saturation et la saturation seront une valeur comprise entre 0% et 100% (par exemple HSL(0,100%,50%) pour Colors.Red).

L’exemple suivant montre comment effectuer une conversion Colors.Red en chaîne HSL :

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToHslString();

ToRgbaString

La méthode ToRgbaString convertit la valeur Color en un string contenant les composantes rouge, verte, bleue et alpha. Le résultat string sera au format : RGB(red,green,blue,alpha) où rouge, vert et bleu seront une valeur comprise entre 0 et 255, et alpha sera une valeur comprise entre 0 et 1 (par exemple RGBA(255,0,0,1) pour Colors.Red).

L’exemple suivant montre comment effectuer une conversion Colors.Red en chaîne RVBA :

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToRgbaString();

Dépend des paramètres de culture, la valeur alpha peut avoir différents délimètres :

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

La méthode ToRgbString convertit la valeur Color en string contenant les composantes rouge, verte et bleue. Le résultat string sera au format : RGB(red,green,blue) où rouge, vert et bleu seront une valeur comprise entre 0 et 255 (par exemple RGB(255,0,0) pour Colors.Red).

L’exemple suivant montre comment effectuer une conversion Colors.Red en chaîne RVB :

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToRgbString();

Avec les composants Color

Les méthodes suivantes vous permettent de remplacer l’un des composants du Color.

WithRed

La WithRed méthode applique l’élément fourni redComponent au Color. Notez que la redComponent valeur peut être comprise double entre 0 et 1, ou entre byte 0 et 255.

L’exemple suivant montre comment appliquer le composant rouge à Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithRed(0.5);

WithGreen

La WithGreen méthode applique l’élément fourni greenComponent au Color. Notez que la greenComponent valeur peut être comprise double entre 0 et 1, ou entre byte 0 et 255.

L’exemple suivant montre comment appliquer le composant vert à Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithGreen(0.5);

WithBlue

La WithBlue méthode applique l’élément fourni blueComponent au Color. Notez que la blueComponent valeur peut être comprise double entre 0 et 1, ou entre byte 0 et 255.

L’exemple suivant montre comment appliquer le composant bleu à Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithBlue(0.5);

WithCyan

La WithCyan méthode applique l’élément fourni cyanComponent au Color. Notez que la cyanComponent valeur doit être comprise entre 0 et 1.

L’exemple suivant montre comment appliquer le composant cyan à Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithCyan(0.5);

WithMagenta

La WithMagenta méthode applique l’élément fourni magentaComponent au Color. Notez que la magentaComponent valeur doit être comprise entre 0 et 1.

L’exemple suivant montre comment appliquer le composant magenta à Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithMagenta(0.5);

WithYellow

La WithYellow méthode applique l’élément fourni yellowComponent au Color. Notez que la yellowComponent valeur doit être comprise entre 0 et 1.

L’exemple suivant montre comment appliquer le composant jaune à Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithYellow(0.5);

WithBlackKey

La WithBlackKey méthode applique l’élément fourni blackKeyComponent au Color. Notez que la blackKeyComponent valeur doit être comprise entre 0 et 1.

L’exemple suivant montre comment appliquer le composant « touche noire » à Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithBlackKey(0.5);

Exemples

Vous trouverez un exemple de cette extension en action dans l’exemple d’application .NET MAUI Community Toolkit.

API

Vous trouverez le code source de ColorConversionExtensions sur le dépôt .NET MAUI Community Toolkit GitHub.