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;
Les méthodes suivantes vous permettent de convertir Color
.
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();
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();
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();
La méthode ToInverseColor
inverse Color
.
L’exemple suivant montre comment inverser Colors.Red
:
using CommunityToolkit.Maui.Extensions.Core;
Colors.Red.ToInverseColor();
Les méthodes suivantes vous permettent de déterminer si Color
est considéré comme sombre.
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();
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();
Les méthodes suivantes vous permettent d’obtenir l’un des composants de Color
.
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();
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();
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();
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();
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();
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();
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();
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();
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();
Les méthodes suivantes vous permettent de convertir Color
en modèle de couleurs string
.
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)"
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();
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)"
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();
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)"
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();
Les méthodes suivantes vous permettent de remplacer l’un des composants de Color
.
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);
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);
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);
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);
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);
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);
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);
Vous trouverez un exemple de cette extension en action dans l’exemple d’application du kit de ressources de la communauté .NET MAUI.
Vous pouvez trouver le code source deColorConversionExtensions
sur le référentiel du kit de ressources de la communauté .NET MAUI sur GitHub.
Commentaires sur .NET MAUI Community Toolkit
.NET MAUI Community Toolkit est un projet open source. Sélectionnez un lien pour fournir des commentaires :