Color.GetHue 方法

定義

命名空間:

System.Drawing

組件:

System.Drawing.Primitives.dll

來源:

Color.cs

取得這個 Color 結構的色調飽和度 -光度 （HSL） 色調值。

C#

public float GetHue ();

傳回

Single

這個 Color的色調，以度為單位。 色調是以度為單位來測量，範圍從0.0到360.0，以 HSL 色彩空間為單位。

範例

下列程式代碼範例是專為搭配 Windows Forms 使用而設計，而且需要 PaintEventArgse，這是 Paint 事件處理程式的參數。 程式代碼會執行下列動作：

• 建立要用於比較之 Color 結構的實例，redShade。

• 逐一查看 KnownColor 列舉元素，以尋找與 redShade具有相同色調的所有已知色彩。 當找到 15 個相符項目或循環計數器的值大於最後一個 KnownColor 元素時，反覆運算就會終止。

• 在每個反覆項目期間，會將 KnownColor 項目儲存在陣列中，如果它符合準則則為 。

• 使用筆刷繪製矩形。

第一個矩形會繪製 redShade所代表的色彩。 每個其他矩形都會繪製符合 redShade色調的 KnownColor。

C#

public void GetHueExample(PaintEventArgs e)
{
    Graphics     g = e.Graphics;
             
    // Color structures. One is a variable used for temporary storage. The other
    // is a constant used for comparisons.
    Color   someColor = Color.FromArgb(0);
    Color   redShade = Color.FromArgb(255, 200, 0, 100);
             
    // Array to store KnownColor values that match the hue of the redShade
    // color.
    KnownColor[]  colorMatches = new KnownColor[15];

    // Number of matches found.
    int  count = 0;   
    
    // Iterate through the KnownColor enums until 15 matches are found.
    for (KnownColor enumValue = 0;
        enumValue <= KnownColor.YellowGreen && count < 15; enumValue++)
    {
        someColor = Color.FromKnownColor(enumValue);
        if (someColor.GetHue() == redShade.GetHue())
            colorMatches[count++] = enumValue;
    }
             
    // Display the redShade color and its argb value.
    SolidBrush  myBrush1 = new SolidBrush(redShade);
    Font        myFont = new Font("Arial", 12);
    int         x = 20;
    int         y = 20;
    someColor = redShade;
    g.FillRectangle(myBrush1, x, y, 100, 30);
    g.DrawString(someColor.ToString(), myFont, Brushes.Black, x + 120, y);
             
    // Iterate through the matches that were found and display each color that
    // corresponds with the enum value in the array. also display the name of
    // the KnownColor.
    for (int i = 0; i < count; i++)
    {
        y += 40;
        someColor = Color.FromKnownColor(colorMatches[i]);
        myBrush1.Color = someColor;
        g.FillRectangle(myBrush1, x, y, 100, 30);
        g.DrawString(someColor.ToString(), myFont, Brushes.Black, x + 120, y);
    }
}

適用於