色彩轉換擴充功能

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 方法會根據 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 方法會反轉 Color。

以下範例顯示如何反轉 Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToInverseColor();

判斷顏色深淺

以下方法可幫助您判斷該產品 Color 是否屬於深色。

為深色

如果 Color 為深色,則使用 IsDark 方法。

以下範例說明如何判斷是否 Colors.Red 被視為暗色:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.IsDark();

對眼睛而言太暗

如果 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方法將青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 alpha 分量取為 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%之間, alpha 則介於 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% 之間,而 Alpha 的值介於 0 到 1 之間(例如 HSLA(0,100%,50%,1) 對應 Colors.Red)。

以下範例展示了如何轉換 Colors.Red 成 HSLA 字串:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToHslaString();

視文化設定而定,alpha 值可能會使用不同的分隔符號:

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 轉換為包含紅、綠、藍及 Alpha 元件的 string。 結果string格式為: RGB(red,green,blue,alpha)其中紅、綠、藍為0到255之間的值,alpha為0到1的值(例如RGBA(255,0,0,1))。Colors.Red

以下範例展示了如何轉換 Colors.Red 成 RGBA 字串:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToRgbaString();

視文化設定而定,alpha 值可能會使用不同的分隔符號:

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 方法將所提供的 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 方法將所提供的 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);

Examples

你可以在 .NET MAUI Community Toolkit Sample Application 找到這個擴充功能的實例。

API

你可以在 ColorConversionExtensions找到 的原始碼。