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();
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).
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).
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).
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).
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);
La source de ce contenu se trouve sur GitHub, où vous pouvez également créer et examiner les problèmes et les demandes de tirage. Pour plus d’informations, consultez notre guide du contributeur.
Commentaires sur .NET MAUI Community Toolkit
.NET MAUI Community Toolkit est un projet open source. Sélectionnez un lien pour fournir des commentaires :
Découvrez comment utiliser des ressources partagées statiques et dynamiques pour créer une interface utilisateur MAUI (.NET Multi-Platform App UI). Découvrez également en quoi les styles peuvent rendre l’interface utilisateur à la fois cohérente et accessible.