ColorConversionExtensions

ColorConversionExtensionsには、Colorの変換、変更、または検査をサポートする一連の拡張メソッドが用意されています。

ColorConversionExtensionsは、CommunityToolkit.Maui.Core.Extensions名前空間の下に表示されるので、開始するには次の行を追加します。

using CommunityToolkit.Maui.Core.Extensions;

色の変換

次のメソッドを使用すると、 Colorを変換できます。

ToBlackOrWhite

ToBlackOrWhiteメソッドは、Colorを Colors.Black または Colors.White のモノクロ値に変換します。

次の例は、 Colors.Red をモノクロ値に変換する方法を示しています。

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToBlackOrWhite();

ToBlackOrWhiteForText

ToBlackOrWhiteForTextメソッドは、Colorが人間の目にとって暗いと判断されたかどうかに基づいて、Colors.BlackをColors.WhiteまたはColorのモノクロ値に変換します。

次の例は、 Colors.Red をモノクロ値に変換する方法を示しています。

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToBlackOrWhiteForText();

ToGrayScale

ToGrayScaleメソッドは、Colorをグレースケール Colorに変換します。

次の例は、 Colors.Red をグレースケール値に変換する方法を示しています。

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToGrayScale();

ToInverseColor

ToInverseColorメソッドは、Colorを反転します。

次の例は、 Colors.Redを反転する方法を示しています。

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToInverseColor();

色の暗さを判断する

次のメソッドを使用すると、 Color が暗いと見なされるかどうかを判断できます。

IsDark

Colorが暗い場合のIsDarkメソッド。

次の例は、 Colors.Red が暗いと見なされるかどうかを判断する方法を示しています。

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.IsDark();

IsDarkForTheEye

Color が人間の目には暗い場合の IsDarkForTheEye メソッド。

次の例は、人間の目に対して Colors.Red が暗いと見なされるかどうかを判断する方法を示しています。

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.IsDarkForTheEye();

色コンポーネントを取得する

次のメソッドを使用すると、 Colorのいずれかのコンポーネントを取得できます。

GetByteRed

GetByteRedメソッドは、のColor成分を 0 から 255 の値として取得します。

次の例は、 Colors.Redの赤いコンポーネントを取得する方法を示しています。

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteRed();

GetByteGreen

GetByteGreenメソッドは、のColorのコンポーネントを 0 から 255 の値として取得します。

次の例は、 Colors.Redの緑色のコンポーネントを取得する方法を示しています。

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteGreen();

GetByteBlue

GetByteBlueメソッドは、のColor成分を 0 から 255 の値として取得します。

次の例は、 Colors.Redの青いコンポーネントを取得する方法を示しています。

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteBlue();

GetDegreeHue

GetDegreeHueメソッドは、のColor成分を 0 から 360 の値として取得します。

次の例は、 Colors.Redの色相コンポーネントを取得する方法を示しています。

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetDegreeHue();

GetPercentCyan

GetPercentCyanメソッドは、のColor成分を 0 から 1 の値として取得します。

次の例は、 Colors.Redのシアン成分を取得する方法を示しています。

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentCyan();

GetPercentMagenta

GetPercentMagentaメソッドは、のColor成分を 0 から 1 の値として取得します。

次の例は、 Colors.Redのマゼンタ コンポーネントを取得する方法を示しています。

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentMagenta();

GetPercentYellow

GetPercentYellowメソッドは、のColorの成分を 0 から 1 の値として取得します。

次の例は、 Colors.Redの黄色のコンポーネントを取得する方法を示しています。

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentYellow();

黒鍵の割合を取得

GetPercentBlackKey メソッドは、のColorコンポーネントを 0 から 1 の値として取得します。

次の例は、 Colors.Redの黒いキー コンポーネントを取得する方法を示しています。

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentBlackKey();

GetByteAlpha

GetByteAlphaメソッドは、のColor成分を 0 から 255 の値として取得します。

次の例は、 Colors.Redのアルファ 成分を取得する方法を示しています。

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteAlpha();

色文字列に変換

次のメソッドを使用すると、 Color を配色 stringに変換できます。

ToCmykaString

ToCmykaStringメソッドは、Colorをシアン、マゼンタ、黄色、および主要なコンポーネントを含むstringに変換します。 結果のstringは、CMYKA(cyan,magenta,yellow,key,alpha)、マゼンタ、黄色、キーが 0% ~ 100%の値になる、アルファは 0 から 1 の値 (たとえば、CMYKA(0%,100%,100%,0%,1)のColors.Red) の形式になります。

次の例は、 Colors.Red を CMYKA 文字列に変換する方法を示しています。

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToCmykaString();

カルチャの設定に応じて、 アルファ 値のデレメータが異なる場合があります。

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

ToCmykStringメソッドは、Colorをシアン、マゼンタ、黄色、および主要なコンポーネントを含むstringに変換します。 結果のstringは次の形式になります。CMYK(cyan,magenta,yellow,key)シアン、マゼンタ、黄色、キーは 0% ~ 100% の値になります (たとえば、CMYK(0%,100%,100%,0%)のColors.Red)。

次の例は、 Colors.Red を CMYK 文字列に変換する方法を示しています。

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToCmykString();

ToHslaString

ToHslaStringメソッドは、Colorをシアン、マゼンタ、黄色、および主要なコンポーネントを含むstringに変換します。 結果のstringは次の形式になります。HSLA(hue,saturation,lightness,alpha)、色相は 0 から 360 の値になり、彩度と彩度は 0% から 100%の値になり、アルファは 0 から 1 の値になります (たとえば、HSLA(0,100%,50%,1)のColors.Red)。

次の例は、 Colors.Red を HSLA 文字列に変換する方法を示しています。

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToHslaString();

カルチャの設定に応じて、 アルファ 値のデレメータが異なる場合があります。

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

ToHslStringメソッドは、Colorをシアン、マゼンタ、黄色、および主要なコンポーネントを含むstringに変換します。 結果のstringは次の形式になります。HSL(hue,saturation,lightness)、色相は 0 から 360 の値になります。彩度と彩度は 0% ~ 100% の値になります (たとえば、HSL(0,100%,50%)のColors.Red)。

次の例は、 Colors.Red を HSL 文字列に変換する方法を示しています。

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToHslString();

ToRgbaString

ToRgbaStringメソッドは、Colorを、赤、緑、青、およびアルファコンポーネントを含むstringに変換します。 結果のstringは次の形式になります。RGB(red,green,blue,alpha)赤、緑、青は 0 から 255 の値になり、アルファは 0 から 1 の値になります (たとえば、RGBA(255,0,0,1)のColors.Red)。

次の例は、 Colors.Red を RGBA 文字列に変換する方法を示しています。

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToRgbaString();

カルチャの設定に応じて、 アルファ 値のデレメータが異なる場合があります。

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

ToRgbString メソッドは、Colorを赤、緑、青の各コンポーネントを含むstringに変換します。 結果のstringは次の形式になります。RGB(red,green,blue)赤、緑、青は 0 ~ 255 の値になります (例: RGB(255,0,0)のColors.Red)。

次の例は、 Colors.Red を RGB 文字列に変換する方法を示しています。

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToRgbString();

色コンポーネントを使用する

次のメソッドを使用すると、 Colorのいずれかのコンポーネントを置き換えることができます。

WithRed

WithRed メソッドは、指定されたredComponentをColorに適用します。 redComponentには、0 ~ 1 のdouble、または 0 から 255 のbyteを指定できます。

次の例は、赤いコンポーネントを Colors.Redに適用する方法を示しています。

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithRed(0.5);

WithGreen

WithGreen メソッドは、指定されたgreenComponentをColorに適用します。 greenComponentには、0 ~ 1 のdouble、または 0 から 255 のbyteを指定できます。

次の例は、緑のコンポーネントを Colors.Redに適用する方法を示しています。

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithGreen(0.5);

WithBlue

WithBlue メソッドは、指定されたblueComponentをColorに適用します。 blueComponentには、0 ~ 1 のdouble、または 0 から 255 のbyteを指定できます。

次の例は、青色のコンポーネントを Colors.Redに適用する方法を示しています。

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithBlue(0.5);

WithCyan

WithCyan メソッドは、指定されたcyanComponentをColorに適用します。 cyanComponentは 0 ~ 1 の値である必要があります。

次の例は、シアン成分を Colors.Redに適用する方法を示しています。

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithCyan(0.5);

WithMagenta

WithMagenta メソッドは、指定されたmagentaComponentをColorに適用します。 magentaComponentは 0 ~ 1 の値である必要があります。

次の例は、 Colors.Redにマゼンタ コンポーネントを適用する方法を示しています。

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithMagenta(0.5);

WithYellow

WithYellow メソッドは、指定されたyellowComponentをColorに適用します。 yellowComponentは 0 ~ 1 の値である必要があります。

次の例は、黄色のコンポーネントを Colors.Redに適用する方法を示しています。

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithYellow(0.5);

WithBlackKey

WithBlackKey メソッドは、指定されたblackKeyComponentをColorに適用します。 blackKeyComponentは 0 ~ 1 の値である必要があります。

次の例は、黒いキー コンポーネントを Colors.Redに適用する方法を示しています。

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithBlackKey(0.5);

例示

この拡張機能の例は、.NET MAUI Community Toolkit サンプル アプリケーションで動作しています。

API

ColorConversionExtensions のソース コードは、.NET MAUI Community Toolkit GitHub リポジトリで確認できます。