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 が人間の目に暗いと判断されたかどうかに基づいて、Color を Colors.Black または Colors.White のモノクロ値に変換します。
次の例は、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
IsDarkForTheEye が人間の目に暗いかどうかは Color メソッド。
次の例は、Colors.Red が人間の目に暗いとみなされるかどうかを判断する方法を示しています。
using CommunityToolkit.Maui.Extensions.Core;
Colors.Red.IsDarkForTheEye();
色要素を取得する
次のメソッドを使用すると、Color 要素の 1 つを取得できます。
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
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 の間の値になります (例: Colors.Red の場合は、CMYKA(0%,100%,100%,0%,1))。
次の例は、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%, の間の値なります (例: Colors.Red の場合は、CMYK(0%,100%,100%,0%))。
次の例は、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 の間の値になります (例: Colors.Red の場合は、HSLA(0,100%,50%,1))。
次の例は、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% の間の値になります (例: Colors.Red の場合は、HSL(0,100%,50%))。
次の例は、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 の間の値になります (例: Colors.Red の場合は、RGBA(255,0,0,1))。
次の例は、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 の間の値になります (例: Colors.Red の場合は、RGB(255,0,0))。
次の例は、Colors.Red を RGB 文字列に変換する方法を示しています。
using CommunityToolkit.Maui.Extensions.Core;
Colors.Red.ToRgbString();
色要素で置き換える
次のメソッドを使用すると、Color 要素の 1 つを置き換えることができます。
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 リポジトリにあります。
.NET MAUI Community Toolkit