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 找到這個擴充功能的實例。