ColorConversionExtensions
Poskytuje ColorConversionExtensions řadu rozšiřujících metod, které podporují převod, úpravy nebo kontrolu Colors.
Najdete ColorConversionExtensions ho pod oborem CommunityToolkit.Maui.Core.Extensions názvů, takže stačí přidat následující řádek, abyste mohli začít:
using CommunityToolkit.Maui.Core.Extensions;
Převést barvy
Následující metody umožňují převést Color.
ToBlackOrWhite
Metoda ToBlackOrWhite převede Color monochromatické hodnoty Colors.Black nebo Colors.White.
Následující příklad ukazuje, jak převést Colors.Red na monochromatické hodnoty:
using CommunityToolkit.Maui.Extensions.Core;
Colors.Red.ToBlackOrWhite();
ToBlackOrWhiteForText
Metoda ToBlackOrWhiteForText převede Color monochromatické hodnoty Colors.Black nebo Colors.White na základě toho, zda Color je určena jako tmavá pro lidské oko.
Následující příklad ukazuje, jak převést Colors.Red na monochromatické hodnoty:
using CommunityToolkit.Maui.Extensions.Core;
Colors.Red.ToBlackOrWhiteForText();
ToGrayScale
Metoda ToGrayScale převede Color na šedé měřítko Color.
Následující příklad ukazuje, jak převést Colors.Red na šedou hodnotu měřítka:
using CommunityToolkit.Maui.Extensions.Core;
Colors.Red.ToGrayScale();
ToInverseColor
Metoda ToInverseColor invertuje Color.
Následující příklad ukazuje, jak invertovat Colors.Red:
using CommunityToolkit.Maui.Extensions.Core;
Colors.Red.ToInverseColor();
Určení barevné temnoty
Následující metody umožňují určit, zda je považován za Color tmavé.
IsDark
Metoda IsDark , pokud Color je tmavá.
Následující příklad ukazuje, jak určit, zda Colors.Red je považován za tmavé:
using CommunityToolkit.Maui.Extensions.Core;
Colors.Red.IsDark();
IsDarkForTheEye
Metoda IsDarkForTheEye , pokud Color je tmavá pro lidské oko.
Následující příklad ukazuje, jak určit, zda Colors.Red je považován za tmavé pro lidské oko:
using CommunityToolkit.Maui.Extensions.Core;
Colors.Red.IsDarkForTheEye();
Získání komponent barev
Následující metody umožňují získat jednu z komponent Color.
GetByteRed
Metoda GetByteRed získá červenou komponentu Color jako hodnotu mezi 0 a 255.
Následující příklad ukazuje, jak získat červenou komponentu Colors.Red:
using CommunityToolkit.Maui.Extensions.Core;
Colors.Red.GetByteRed();
GetByteGreen
Metoda GetByteGreen získá zelenou komponentu Color jako hodnotu mezi 0 a 255.
Následující příklad ukazuje, jak získat zelenou komponentu Colors.Red:
using CommunityToolkit.Maui.Extensions.Core;
Colors.Red.GetByteGreen();
GetByteBlue
Metoda GetByteBlue získá modrou komponentu Color jako hodnotu mezi 0 a 255.
Následující příklad ukazuje, jak získat modrou komponentu Colors.Red:
using CommunityToolkit.Maui.Extensions.Core;
Colors.Red.GetByteBlue();
GetDegreeHue
Metoda GetDegreeHue získá součást odstínuColor jako hodnotu mezi 0 a 360.
Následující příklad ukazuje, jak získat hue součást Colors.Red:
using CommunityToolkit.Maui.Extensions.Core;
Colors.Red.GetDegreeHue();
GetPercentCyan
Metoda GetPercentCyan získá azurovou složku Color jako hodnotu mezi 0 a 1.
Následující příklad ukazuje, jak získat azurovou komponentu Colors.Red:
using CommunityToolkit.Maui.Extensions.Core;
Colors.Red.GetPercentCyan();
GetPercentMagenta
Metoda GetPercentMagenta získá purpurovou komponentu Color jako hodnotu mezi 0 a 1.
Následující příklad ukazuje, jak získat purpurovou komponentu Colors.Red:
using CommunityToolkit.Maui.Extensions.Core;
Colors.Red.GetPercentMagenta();
GetPercentYellow
Metoda GetPercentYellow získá žlutou komponentu Color jako hodnotu mezi 0 a 1.
Následující příklad ukazuje, jak získat žlutou komponentu Colors.Red:
using CommunityToolkit.Maui.Extensions.Core;
Colors.Red.GetPercentYellow();
GetPercentBlackKey
Metoda GetPercentBlackKey získá složku černého Color klíče jako hodnotu mezi 0 a 1.
Následující příklad ukazuje, jak získat černou klíč součást Colors.Red:
using CommunityToolkit.Maui.Extensions.Core;
Colors.Red.GetPercentBlackKey();
GetByteAlpha
Metoda GetByteAlpha získá alfa komponentu Color jako hodnotu mezi 0 a 255.
Následující příklad ukazuje, jak získat alfa komponentu Colors.Red:
using CommunityToolkit.Maui.Extensions.Core;
Colors.Red.GetByteAlpha();
Barva řetězce
Následující metody umožňují převést Color na barevné schéma string.
ToCmykaString
Metoda ToCmykaString převede Color na string azurovou, purpurovou, žlutou a klíčovou komponentu. Výsledek string bude ve formátu: CMYKA(cyan,magenta,yellow,key,alpha) kde azurová, purpurová, žlutá a klíč bude hodnota mezi 0 % a 100 % a alfa bude hodnota mezi 0 a 1 (např. CMYKA(0%,100%,100%,0%,1) pro Colors.Red).
Následující příklad ukazuje, jak převést Colors.Red na řetězec CMYKA:
using CommunityToolkit.Maui.Extensions.Core;
Colors.Red.ToCmykaString();
Závisí na nastavení jazykové verze, alfa hodnota může mít jiný delimetr:
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
Metoda ToCmykString převede Color na string azurovou, purpurovou, žlutou a klíčovou komponentu. Výsledek string bude ve formátu: CMYK(cyan,magenta,yellow,key) kde azurová, purpurová, žlutá a klávesa bude hodnota mezi 0 % a 100 % (např. CMYK(0%,100%,100%,0%) pro Colors.Red).
Následující příklad ukazuje, jak převést Colors.Red na řetězec CMYK:
using CommunityToolkit.Maui.Extensions.Core;
Colors.Red.ToCmykString();
ToHslaString
Metoda ToHslaString převede Color na string azurovou, purpurovou, žlutou a klíčovou komponentu. Výsledek string bude ve formátu: HSLA(hue,saturation,lightness,alpha) kde odstín bude hodnota mezi 0 a 360, sytost a sytost bude hodnota mezi 0 a 100 % a alfa bude hodnota mezi 0 a 1 (např. HSLA(0,100%,50%,1) proColors.Red).
Následující příklad ukazuje, jak převést Colors.Red na řetězec HSLA:
using CommunityToolkit.Maui.Extensions.Core;
Colors.Red.ToHslaString();
Závisí na nastavení jazykové verze, alfa hodnota může mít jiný delimetr:
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
Metoda ToHslString převede Color na string azurovou, purpurovou, žlutou a klíčovou komponentu. Výsledek string bude ve formátu: HSL(hue,saturation,lightness) kde odstín bude hodnota mezi 0 a 360, sytost a sytost bude hodnota mezi 0 % a 100 % (např. HSL(0,100%,50%) pro Colors.Red).
Následující příklad ukazuje, jak převést Colors.Red na řetězec HSL:
using CommunityToolkit.Maui.Extensions.Core;
Colors.Red.ToHslString();
ToRgbaString
Metoda ToRgbaString převede Color na červenou string , zelenou, modrou a alfa komponentu. Výsledek string bude ve formátu: RGB(red,green,blue,alpha)kde červená, zelená a modrá bude hodnota mezi 0 a 255 a alfa bude hodnota mezi 0 a 1 (např. RGBA(255,0,0,1) proColors.Red).
Následující příklad ukazuje, jak převést Colors.Red na řetězec RGBA:
using CommunityToolkit.Maui.Extensions.Core;
Colors.Red.ToRgbaString();
Závisí na nastavení jazykové verze, alfa hodnota může mít jiný delimetr:
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
Metoda ToRgbString převede Color na červenou string , zelenou a modrou komponentu. Výsledek string bude ve formátu: RGB(red,green,blue)červená, zelená a modrá bude hodnota mezi 0 a 255 (např. RGB(255,0,0) pro).Colors.Red
Následující příklad ukazuje, jak převést Colors.Red na řetězec RGB:
using CommunityToolkit.Maui.Extensions.Core;
Colors.Red.ToRgbString();
S komponentami Barev
Následující metody umožňují nahradit jednu z komponent Color.
Sred
Metoda WithRed použije zadaný redComponent na Color. Všimněte si, že redComponent může být double mezi 0 a 1 nebo byte mezi 0 a 255.
Následující příklad ukazuje, jak použít červenou komponentu na Colors.Red:
using CommunityToolkit.Maui.Extensions.Core;
Colors.Red.WithRed(0.5);
Segreen
Metoda WithGreen použije zadaný greenComponent na Color. Všimněte si, že greenComponent může být double mezi 0 a 1 nebo byte mezi 0 a 255.
Následující příklad ukazuje, jak použít zelenou komponentu na Colors.Red:
using CommunityToolkit.Maui.Extensions.Core;
Colors.Red.WithGreen(0.5);
Smodrá
Metoda WithBlue použije zadaný blueComponent na Color. Všimněte si, že blueComponent může být double mezi 0 a 1 nebo byte mezi 0 a 255.
Následující příklad ukazuje, jak použít modrou komponentu na Colors.Red:
using CommunityToolkit.Maui.Extensions.Core;
Colors.Red.WithBlue(0.5);
WithCyan
Metoda WithCyan použije zadaný cyanComponent na Color. Všimněte si, že cyanComponent hodnota musí být v rozmezí od 0 do 1.
Následující příklad ukazuje, jak použít azurovou komponentu na Colors.Red:
using CommunityToolkit.Maui.Extensions.Core;
Colors.Red.WithCyan(0.5);
WithMagenta
Metoda WithMagenta použije zadaný magentaComponent na Color. Všimněte si, že magentaComponent hodnota musí být v rozmezí od 0 do 1.
Následující příklad ukazuje, jak použít purpurovou komponentu na Colors.Red:
using CommunityToolkit.Maui.Extensions.Core;
Colors.Red.WithMagenta(0.5);
SYellow
Metoda WithYellow použije zadaný yellowComponent na Color. Všimněte si, že yellowComponent hodnota musí být v rozmezí od 0 do 1.
Následující příklad ukazuje, jak použít žlutou komponentu na Colors.Red:
using CommunityToolkit.Maui.Extensions.Core;
Colors.Red.WithYellow(0.5);
WithBlackKey
Metoda WithBlackKey použije zadaný blackKeyComponent na Color. Všimněte si, že blackKeyComponent hodnota musí být v rozmezí od 0 do 1.
Následující příklad ukazuje, jak použít černou klíč komponentu na Colors.Red:
using CommunityToolkit.Maui.Extensions.Core;
Colors.Red.WithBlackKey(0.5);
Příklady
Příklad tohoto rozšíření najdete v akci v ukázkové aplikaci .NET MAUI Community Toolkit.
rozhraní API
Zdrojový kód ColorConversionExtensions najdete v úložišti .NET MAUI Community Toolkit na GitHubu.
.NET MAUI Community Toolkit