ColorConversionExtensions

De ColorConversionExtensions bieden een reeks uitbreidingsmethoden die ondersteuning bieden voor het converteren, wijzigen of inspecteren van Colors.

De ColorConversionExtensions is te vinden in de naamruimte CommunityToolkit.Maui.Core.Extensions, dus voeg de volgende regel toe om te beginnen:

using CommunityToolkit.Maui.Core.Extensions;

Kleuren converteren

Met de volgende methoden kunt u de Color converteren.

ToBlackOrWhite

De ToBlackOrWhite methode converteert de Color naar een monochrome waarde van Colors.Black of Colors.White.

In het volgende voorbeeld ziet u hoe u converteert Colors.Red naar een monochrome waarde:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToBlackOrWhite();

ToBlackOrWhiteForText

De methode ToBlackOrWhiteForText zet de Color om in een monochrome waarde van Colors.Black of Colors.White, afhankelijk van of de Color voor het menselijk oog als donker wordt beschouwd.

In het volgende voorbeeld ziet u hoe u converteert Colors.Red naar een monochrome waarde:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToBlackOrWhiteForText();

ToGrayScale

De ToGrayScale methode converteert de Color naar een grijze schaal Color.

In het volgende voorbeeld ziet u hoe u converteert Colors.Red naar een grijze schaalwaarde:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToGrayScale();

ToInverseColor

De ToInverseColor methode omkert de Color.

In het volgende voorbeeld ziet u hoe u kunt omkeren Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToInverseColor();

De donkerheid van een kleur bepalen

Met de volgende methoden kunt u bepalen of het Color als donker wordt beschouwd.

IsDark

De IsDark methode als het Color donker is.

In het volgende voorbeeld ziet u hoe u kunt bepalen of Colors.Red deze als donker wordt beschouwd:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.IsDark();

IsDarkForTheEye

De IsDarkForTheEye methode als het Color donker is voor het menselijke oog.

In het volgende voorbeeld ziet u hoe u kunt bepalen of Colors.Red door het menselijk oog als donker wordt waargenomen:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.IsDarkForTheEye();

Kleuronderdelen ophalen

Met de volgende methoden kunt u een van de onderdelen van de Color.

GetByteRed

De GetByteRed methode haalt het rode onderdeel van Color als een waarde tussen 0 en 255.

In het volgende voorbeeld ziet u hoe u de rode component van Colors.Red kunt ophalen:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteRed();

GetByteGreen

De GetByteGreen methode haalt het groene onderdeel van Color als een waarde tussen 0 en 255.

In het volgende voorbeeld ziet u hoe u de groene component van Colors.Red ophaalt:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteGreen();

GetByteBlue

De GetByteBlue methode haalt het blauwe onderdeel van Color als een waarde tussen 0 en 255.

In het volgende voorbeeld ziet u hoe u de blauwe component van Colors.Red kunt ophalen:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteBlue();

GetDegreeHue

De GetDegreeHue methode haalt het tint-onderdeel van Color als een waarde tussen 0 en 360.

In het volgende voorbeeld wordt getoond hoe u de tintcomponent van Colors.Red kunt ophalen:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetDegreeHue();

GetPercentCyan

De GetPercentCyan methode haalt het cyaan-onderdeel van Color als een waarde tussen 0 en 1.

In het volgende voorbeeld ziet u hoe u de cyaancomponent van Colors.Red kunt ophalen:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentCyan();

GetPercentMagenta

Met de methode GetPercentMagenta wordt de magentacomponent van Color opgehaald als waarde tussen 0 en 1.

In het volgende voorbeeld wordt getoond hoe u de magentacomponent van Colors.Red kunt ophalen:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentMagenta();

GetPercentYellow

De GetPercentYellow methode haalt het gele onderdeel van Color als een waarde tussen 0 en 1.

In het volgende voorbeeld wordt getoond hoe u de gele component van Colors.Red kunt ophalen:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentYellow();

GetPercentBlackKey

De GetPercentBlackKey methode haalt het zwarte-sleutelonderdeel van Color als een waarde tussen 0 en 1.

In het volgende voorbeeld ziet u hoe u het onderdeel van de zwarte toets van Colors.Red ophaalt:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentBlackKey();

GetByteAlpha

De GetByteAlpha methode haalt het alfa-onderdeel van Color als een waarde tussen 0 en 255.

In het volgende voorbeeld wordt weergegeven hoe u de alfacomponent van Colors.Red kunt ophalen:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteAlpha();

Naar kleurtekenreeks

Met de volgende methoden kunt u het Color converteren naar een kleurenschema string.

ToCmykaString

De ToCmykaString methode converteert de Color naar een string met de cyaan, magenta, gele en sleutelonderdelen. Het resultaat string is in de notatie: CMYKA(cyan,magenta,yellow,key,alpha) waarbij cyaan, magenta, geel en sleutel een waarde is tussen 0% en 100%, en alfa een waarde tussen 0 en 1 (bijvoorbeeld CMYKA(0%,100%,100%,0%,1) voor Colors.Red).

In het volgende voorbeeld ziet u hoe u converteert Colors.Red naar een CMYKA-tekenreeks:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToCmykaString();

Afhankelijk van de cultuurinstellingen kan de alfawaarde verschillende delimeter hebben:

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

De ToCmykString methode converteert de Color naar een string met de cyaan, magenta, gele en sleutelonderdelen. Het resultaat string heeft de volgende notatie: CMYK(cyan,magenta,yellow,key) waarbij cyaan, magenta, geel en sleutel een waarde zijn tussen 0% en 100% (bijvoorbeeld CMYK(0%,100%,100%,0%) voor Colors.Red).

In het volgende voorbeeld ziet u hoe u converteert Colors.Red naar een CMYK-tekenreeks:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToCmykString();

ToHslaString

De ToHslaString methode converteert de Color naar een string met de cyaan, magenta, gele en sleutelonderdelen. De resulterende string zal de notatie hebben: HSLA(hue,saturation,lightness,alpha) waarbij tint een waarde tussen 0 en 360 zal zijn, verzadiging en verzadiging waarden tussen 0% en 100% zullen zijn, en alfa een waarde tussen 0 en 1 zal zijn (bijvoorbeeld HSLA(0,100%,50%,1) voor Colors.Red).

In het volgende voorbeeld ziet u hoe u converteert Colors.Red naar een HSLA-tekenreeks:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToHslaString();

Afhankelijk van de cultuurinstellingen kan de alfawaarde verschillende delimeter hebben:

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

De ToHslString methode converteert de Color naar een string met de cyaan, magenta, gele en sleutelonderdelen. Het resultaat string heeft de volgende notatie: HSL(hue,saturation,lightness) waarbij tint een waarde is tussen 0 en 360, verzadiging en verzadiging een waarde tussen 0% en 100% (bijvoorbeeld HSL(0,100%,50%) voor Colors.Red).

In het volgende voorbeeld ziet u hoe u converteert Colors.Red naar een HSL-tekenreeks:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToHslString();

ToRgbaString

De ToRgbaString methode converteert de Color naar een string met de rode, groene, blauwe en alfa-onderdelen. Het resultaat string heeft de volgende notatie: RGB(red,green,blue,alpha) waarbij rood, groen en blauw een waarde tussen 0 en 255 is en alfa een waarde is tussen 0 en 1 (bijvoorbeeld RGBA(255,0,0,1) voor Colors.Red).

In het volgende voorbeeld ziet u hoe u converteert Colors.Red naar een RGBA-tekenreeks:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToRgbaString();

Afhankelijk van de cultuurinstellingen kan de alfawaarde verschillende delimeter hebben:

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

De ToRgbString methode converteert de Color naar een string met de rode, groene en blauwe componenten. Het resultaat string heeft de volgende notatie: RGB(red,green,blue) waarbij rood, groen en blauw een waarde is tussen 0 en 255 (bijvoorbeeld RGB(255,0,0) voor Colors.Red).

In het volgende voorbeeld ziet u hoe u converteert Colors.Red naar een RGB-tekenreeks:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToRgbString();

Met kleuronderdelen

De volgende methoden stellen u in staat een van de componenten van de Color te vervangen.

WithRed

De WithRed methode past de opgegeven redComponent methode toe op de Color. Let op: de redComponent waarde kan double tussen 0 en 1 of tussen byte 0 en 255 zijn.

In het volgende voorbeeld ziet u hoe u het rode onderdeel toepast op Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithRed(0.5);

WithGreen

De WithGreen methode past de opgegeven greenComponent methode toe op de Color. Let op: de greenComponent waarde kan double tussen 0 en 1 of tussen byte 0 en 255 zijn.

In het volgende voorbeeld ziet u hoe u het groene onderdeel toepast op Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithGreen(0.5);

WithBlue

De WithBlue methode past de opgegeven blueComponent methode toe op de Color. Let op: de blueComponent waarde kan double tussen 0 en 1 of tussen byte 0 en 255 zijn.

In het volgende voorbeeld ziet u hoe u het blauwe onderdeel toepast op Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithBlue(0.5);

WithCyan

De WithCyan methode past de opgegeven cyanComponent methode toe op de Color. Let op: de cyanComponent waarde moet tussen 0 en 1 zijn.

In het volgende voorbeeld ziet u hoe u het cyaan-onderdeel toepast op Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithCyan(0.5);

WithMagenta

De WithMagenta methode past de opgegeven magentaComponent methode toe op de Color. Let op: de magentaComponent waarde moet tussen 0 en 1 zijn.

In het volgende voorbeeld ziet u hoe u het magenta-onderdeel toepast op Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithMagenta(0.5);

WithYellow

De WithYellow methode past de opgegeven yellowComponent methode toe op de Color. Let op: de yellowComponent waarde moet tussen 0 en 1 zijn.

In het volgende voorbeeld ziet u hoe u het gele onderdeel toepast op Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithYellow(0.5);

WithBlackKey

De WithBlackKey methode past de opgegeven blackKeyComponent methode toe op de Color. Let op: de blackKeyComponent waarde moet tussen 0 en 1 zijn.

In het volgende voorbeeld ziet u hoe u de zwarte toets-component toepast op Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithBlackKey(0.5);

Examples

U vindt een voorbeeld van deze extensie in actie in de .NET MAUI Community Toolkit Sample Application.

API

U vindt de broncode voor ColorConversionExtensions in de .NET MAUI Community Toolkit GitHub opslagplaats.