Color.GetSaturation Método

Definición

Espacio de nombres:

System.Drawing

Ensamblado:

System.Drawing.Primitives.dll

Source:

Color.cs

Obtiene el valor de saturación de tono-saturación (HSL) de esta estructura Color.

C#

public float GetSaturation ();

Devoluciones

Single

Saturación de este Color. La saturación oscila entre 0,0 y 1,0, donde 0,0 es la escala de grises y 1,0 es la más saturada.

Ejemplos

El ejemplo de código siguiente está diseñado para su uso con Windows Forms y requiere PaintEventArgse, que es un parámetro del controlador de eventos Paint. El código realiza las siguientes acciones:

• Crea una instancia de una estructura de Color, redShade, que se usará para las comparaciones.

• Recorre en iteración los elementos de enumeración KnownColor para encontrar todos los colores conocidos que tienen la misma saturación que redShade. Las iteraciones se finalizan cuando se encuentran 15 coincidencias o el valor del contador de bucle es mayor que el último elemento KnownColor.

• Durante cada iteración, guarda el elemento KnownColor , si coincide con los criterios, en una matriz.

• Usa un pincel para pintar rectángulos.

El primer rectángulo se pinta el color representado por redShade. Cada uno de los otros rectángulos se pinta un KnownColor que coincide con la saturación del redShade.

C#

public void GetSatExample(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 saturation 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.GetSaturation() == redShade.GetSaturation())
            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);
    }
}

Se aplica a