Color.GetHue Método

Definição

Namespace:

System.Drawing

Assembly:

System.Drawing.Primitives.dll

Origem:

Color.cs

Obtém o valor de matiz de HSL (hue-saturation-lightness), em graus, para essa estrutura Color.

C#

public float GetHue ();

Retornos

Single

A tonalidade, em graus, deste Color. A tonalidade é medida em graus, variando de 0,0 a 360,0, no espaço de cor HSL.

Exemplos

O exemplo de código a seguir foi projetado para uso com o Windows Forms e requer PaintEventArgse, que é um parâmetro do manipulador de eventos Paint. O código executa as seguintes ações:

• Cria uma instância de uma estrutura Color, redShade, a ser usada para comparações.

• Itera por meio dos elementos de enumeração KnownColor para localizar todas as cores conhecidas que têm a mesma tonalidade que redShade. As iterações são encerradas quando 15 correspondências são encontradas ou o valor do contador de loop é maior que o último elemento KnownColor.

• Durante cada iteração, salva o elemento KnownColor - se corresponder aos critérios - em uma matriz.

• Usa um pincel para pintar retângulos.

O primeiro retângulo é pintado com a cor representada por redShade. Cada um dos outros retângulos é pintado um KnownColor que corresponde à tonalidade do redShade.

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);
    }
}

Aplica-se a