ColorConversionExtensions

L’extension ColorConversionExtensions fournit une série de méthodes d’extension qui prennent en charge la conversion, la modification ou l’inspection de Color.

L’extension ColorConversionExtensions se trouve sous l’espace de noms CommunityToolkit.Maui.Core.Extensions. Il vous suffit donc d’ajouter la ligne suivante pour commencer :

using CommunityToolkit.Maui.Core.Extensions;

Convertir les couleurs

Les méthodes suivantes vous permettent de convertir Color.

ToBlackOrWhite

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

L’exemple suivant montre comment convertir Colors.Red en valeur monochrome :

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToBlackOrWhite();

ToBlackOrWhiteForText

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

L’exemple suivant montre comment convertir Colors.Red en valeur monochrome :

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToBlackOrWhiteForText();

ToGrayScale

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

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

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToGrayScale();

ToInverseColor

La méthode ToInverseColor inverse Color.

L’exemple suivant montre comment inverser Colors.Red :

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToInverseColor();

Détermination de l’intensité de la couleur

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

IsDark

Méthode IsDark si Color est sombre.

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

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.IsDark();

IsDarkForTheEye

Méthode IsDarkForTheEye si Color est sombre pour l’œil humain.

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

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.IsDarkForTheEye();

Obtenir les composants d’une couleur

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

GetByteRed

La méthode GetByteRed obtient le composant red (rouge) de Color sous forme de valeur comprise entre 0 et 255.

L’exemple suivant montre comment obtenir le composant lié au rouge pour Colors.Red :

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteRed();

GetByteGreen

La méthode GetByteGreen obtient le composant green (vert) de Color sous forme de valeur comprise entre 0 et 255.

L’exemple suivant montre comment obtenir le composant lié au vert pour Colors.Red :

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteGreen();

GetByteBlue

La méthode GetByteBlue obtient le composant blue (bleu) de Color sous forme de valeur comprise entre 0 et 255.

L’exemple suivant montre comment obtenir le composant lié au bleu pour Colors.Red :

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteBlue();

GetDegreeHue

La méthode GetDegreeHue obtient le composant hue (teinte) de Color sous forme de valeur comprise entre 0 et 360.

L’exemple suivant montre comment obtenir le composant lié à la teinte pour Colors.Red :

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetDegreeHue();

GetPercentCyan

La méthode GetPercentCyan obtient le composant cyan (cyan) de Color sous forme de valeur comprise entre 0 et 1.

L’exemple suivant montre comment obtenir le composant lié au cyan pour Colors.Red :

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentCyan();

GetPercentMagenta

La méthode GetPercentMagenta obtient le composant magenta (magenta) de Color sous forme de valeur comprise entre 0 et 1.

L’exemple suivant montre comment obtenir le composant lié au magenta pour Colors.Red :

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentMagenta();

GetPercentYellow

La méthode GetPercentYellow obtient le composant yellow (jaune) de Color sous forme de valeur comprise entre 0 et 1.

L’exemple suivant montre comment obtenir le composant lié au jaune pour Colors.Red :

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentYellow();

GetPercentBlackKey

La méthode GetPercentBlackKey obtient le composant black key (clé de noir) de Color sous forme de valeur comprise entre 0 et 1.

L’exemple suivant montre comment obtenir le composant lié à la clé de noir pour Colors.Red :

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentBlackKey();

GetByteAlpha

La méthode GetByteAlpha obtient le composant alpha (alpha) de Color sous forme de valeur comprise entre 0 et 255.

L’exemple suivant montre comment obtenir le composant lié à la valeur alpha pour Colors.Red :

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteAlpha();

Convertir en représentation d’une couleur sous forme de chaîne

Les méthodes suivantes vous permettent de convertir Color en modèle de couleurs string.

ToCmykaString

La méthode ToCmykaString convertit Color en string contenant les composants cyan, magenta, yellow et key (cyan, magenta, jaune et clé). Le string résultant est au format CMYKA(cyan,magenta,yellow,key,alpha) où cyan, magenta, yellow et key correspond à une valeur comprise entre 0 % et 100 %, et alpha correspond à une valeur comprise entre 0 et 1 (par exemple CMYKA(0%,100%,100%,0%,1) pour Colors.Red).

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

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToCmykaString();

En fonction des paramètres de culture, la valeur alpha peut avoir un autre délimiteur :

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 Color en string contenant les composants cyan, magenta, yellow et key (cyan, magenta, jaune et clé). Le string résultant est au format CMYK(cyan,magenta,yellow,key) où cyan, magenta, yellow et key correspond à 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 Color en string contenant les composants cyan, magenta, yellow et key (cyan, magenta, jaune et clé). Le string résultant est au format HSLA(hue,saturation,lightness,alpha) où hue (teinte) correspond à une valeur comprise entre 0 et 360, saturation et lightness (clarté) correspondent à une valeur comprise entre 0 % et 100 %, et alpha correspond à 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 (TSLA) :

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToHslaString();

En fonction des paramètres de culture, la valeur alpha peut avoir un autre délimiteur :

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 Color en string contenant les composants cyan, magenta, yellow et key (cyan, magenta, jaune et clé). Le string résultant est au format HSL(hue,saturation,lightness) où hue (teinte) correspond à une valeur comprise entre 0 et 360, saturation et lightness (clarté) correspondent à une valeur comprise entre 0 % et 100 % (par exemple HSL(0,100%,50%) pour Colors.Red).

L’exemple suivant montre comment convertir Colors.Red en chaîne HSL (TSL) :

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToHslString();

ToRgbaString

La méthode ToRgbaString convertit Color en string contenant les composants red, green, blue et alpha (rouge, vert, bleu et alpha). Le string résultant est au format RGB(red,green,blue,alpha) où red, green et blue correspondent à une valeur comprise entre 0 et 255, et alpha correspond à une valeur comprise entre 0 et 1 (par exemple RGBA(255,0,0,1) pour Colors.Red).

L’exemple suivant montre comment convertir Colors.Red en chaîne RGBA (RVBA) :

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToRgbaString();

En fonction des paramètres de culture, la valeur alpha peut avoir un autre délimiteur :

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 Color en string contenant les composants red, green et blue (rouge, vert et bleu). Le string résultant est au format RGB(red,green,blue) où red, green et blue correspondent à une valeur comprise entre 0 et 255 (par exemple RGB(255,0,0) pour Colors.Red).

L’exemple suivant montre comment convertir Colors.Red en chaîne RGB (RVB) :

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToRgbString();

Avec les composants d’une couleur

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

WithRed

La méthode WithRed applique le redComponent fourni à Color. Notez que redComponent peut être un double compris entre 0 et 1, ou un byte compris entre 0 et 255.

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

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithRed(0.5);

WithGreen

La méthode WithGreen applique le greenComponent fourni à Color. Notez que greenComponent peut être un double compris entre 0 et 1, ou un byte compris entre 0 et 255.

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

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithGreen(0.5);

WithBlue

La méthode WithBlue applique le blueComponent fourni à Color. Notez que blueComponent peut être un double compris entre 0 et 1, ou un byte compris entre 0 et 255.

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

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithBlue(0.5);

WithCyan

La méthode WithCyan applique le cyanComponent fourni à Color. Notez que cyanComponent doit être une valeur comprise entre 0 et 1.

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

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithCyan(0.5);

WithMagenta

La méthode WithMagenta applique le magentaComponent fourni à Color. Notez que magentaComponent doit être une valeur comprise entre 0 et 1.

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

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithMagenta(0.5);

WithYellow

La méthode WithYellow applique le yellowComponent fourni à Color. Notez que yellowComponent doit être une valeur comprise entre 0 et 1.

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

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithYellow(0.5);

WithBlackKey

La méthode WithBlackKey applique le blackKeyComponent fourni à Color. Notez que blackKeyComponent doit être une valeur comprise entre 0 et 1.

L’exemple suivant montre comment appliquer le composant lié à la clé de noir à 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 du kit de ressources de la communauté .NET MAUI.

API

Vous pouvez trouver le code source deColorConversionExtensions sur le référentiel du kit de ressources de la communauté .NET MAUI sur GitHub.