Color.ToString Método

Definição

Namespace:

System.Drawing

Assemblies:

netstandard.dll, System.Drawing.Primitives.dll

Origem:

Color.cs

Converte essa estrutura Color em uma cadeia de caracteres legível por humanos.

C#

public override string ToString();

Retornos

String

Uma cadeia de caracteres que é o nome deste Color, se o Color for criado a partir de uma cor predefinida usando o método FromName(String) ou o método FromKnownColor(KnownColor); caso contrário, uma cadeia de caracteres que consiste nos nomes de componente ARGB e seus valores.

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:

• Itera por meio dos elementos de enumeração KnownColor para localizar todas as cores conhecidas que têm um componente verde diferente de zero e um componente vermelho de valor zero e que não são cores do sistema.

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

• Usa um pincel para pintar retângulos. Cada um dos retângulos é pintado um KnownColor que corresponde aos critérios indicados na primeira etapa. O nome do KnownColor e seus valores de componente também são exibidos.

Este exemplo exibe determinadas cores conhecidas e usa ToString para exibir os nomes das cores e seus quatro valores de componente.

C#

public void ToArgbToStringExample2(PaintEventArgs e)
{
    Graphics     g = e.Graphics;
             
    // Color structure used for temporary storage.
    Color   someColor = Color.FromArgb(0);
             
    // Array to store KnownColor values that match the criteria.
    KnownColor[]  colorMatches = new KnownColor[167];
    
    // Number of matches found.
    int  count = 0;   
             
    // Iterate through the KnownColor enums to find all corresponding colors
    // that have a nonzero green component and zero-value red component and
    // that are not system colors.
    for (KnownColor enumValue = 0;
        enumValue <= KnownColor.YellowGreen; enumValue++)
    {
        someColor = Color.FromKnownColor(enumValue);
        if (someColor.G != 0 && someColor.R == 0 && !someColor.IsSystemColor)
            colorMatches[count++] = enumValue;
    }
    SolidBrush  myBrush1 = new SolidBrush(someColor);
    Font        myFont = new Font("Arial", 9);
    int         x = 40;
    int         y = 40;
             
    // 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 and the ARGB components.
    for (int i = 0; i < count; i++)
    {
        // Display the color.
        someColor = Color.FromKnownColor(colorMatches[i]);
        myBrush1.Color = someColor;
        g.FillRectangle(myBrush1, x, y, 50, 30);
             
        // Display KnownColor name and the four component values. To display the
        // component values:  Use the ToArgb method to get the 32-bit ARGB value
        // of someColor, which was created from a KnownColor. Then create a
        // Color structure from the 32-bit ARGB value and set someColor equal to
        // this new Color structure. Then use the ToString method to convert it to
        // a string.
        g.DrawString(someColor.ToString(), myFont, Brushes.Black, x + 55, y);
        someColor = Color.FromArgb(someColor.ToArgb());
        g.DrawString(someColor.ToString(), myFont, Brushes.Black, x + 55, y + 15);
        y += 40;
    }
}

Comentários

Uma cor predefinida também é chamada de cor conhecida e é representada por um elemento da enumeração KnownColor. Quando o método ToString é aplicado a uma estrutura Color criada usando o método FromArgb, ToString retorna uma cadeia de caracteres que consiste nos nomes de componente ARGB e seus valores, mesmo que o valor ARGB corresponda ao valor ARGB de uma cor predefinida.

Aplica-se a