Color Struct

Definition

Represents an ARGB (alpha, red, green, blue) color.

public value class Color : IEquatable<System::Drawing::Color>
public value class Color
[System.ComponentModel.TypeConverter("System.Drawing.ColorConverter, System.Drawing, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public readonly struct Color : IEquatable<System.Drawing.Color>
public struct Color : IEquatable<System.Drawing.Color>
public readonly struct Color : IEquatable<System.Drawing.Color>
[System.ComponentModel.TypeConverter(typeof(System.Drawing.ColorConverter))]
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public struct Color
[System.ComponentModel.TypeConverter(typeof(System.Drawing.ColorConverter))]
[System.Serializable]
public struct Color
public struct Color
[<System.ComponentModel.TypeConverter("System.Drawing.ColorConverter, System.Drawing, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
type Color = struct
type Color = struct
[<System.ComponentModel.TypeConverter(typeof(System.Drawing.ColorConverter))>]
[<System.Runtime.InteropServices.ComVisible(true)>]
[<System.Serializable>]
type Color = struct
[<System.ComponentModel.TypeConverter(typeof(System.Drawing.ColorConverter))>]
[<System.Serializable>]
type Color = struct
Public Structure Color
Implements IEquatable(Of Color)
Public Structure Color
Inheritance
Attributes
Implements

Examples

The following code example demonstrates the A, R, G, and B properties of a Color, and the Implicit member.

This example is designed to be used with a Windows Form. Paste the code into the form and call the ShowPropertiesOfSlateBlue method from the form's Paint event-handling method, passing e as PaintEventArgs.

void ShowPropertiesOfSlateBlue( PaintEventArgs^ e )
{
   Color slateBlue = Color::FromName( "SlateBlue" );
   Byte g = slateBlue.G;
   Byte b = slateBlue.B;
   Byte r = slateBlue.R;
   Byte a = slateBlue.A;
   array<Object^>^temp0 = {a,r,g,b};
   String^ text = String::Format( "Slate Blue has these ARGB values: Alpha:{0}, "
   "red:{1}, green: {2}, blue {3}", temp0 );
   e->Graphics->DrawString( text, gcnew System::Drawing::Font( this->Font,FontStyle::Italic ), gcnew SolidBrush( slateBlue ), RectangleF(PointF(0.0F,0.0F),this->Size) );
}
private void ShowPropertiesOfSlateBlue(PaintEventArgs e)
{
    Color slateBlue = Color.FromName("SlateBlue");
    byte g = slateBlue.G;
    byte b = slateBlue.B;
    byte r = slateBlue.R;
    byte a = slateBlue.A;
    string text = String.Format("Slate Blue has these ARGB values: Alpha:{0}, " +
        "red:{1}, green: {2}, blue {3}", new object[]{a, r, g, b});
    e.Graphics.DrawString(text, 
        new Font(this.Font, FontStyle.Italic), 
        new SolidBrush(slateBlue), 
        new RectangleF(new PointF(0.0F, 0.0F), this.Size));
}
Private Sub ShowPropertiesOfSlateBlue(ByVal e As PaintEventArgs)
    Dim slateBlue As Color = Color.FromName("SlateBlue")
    Dim g As Byte = slateBlue.G
    Dim b As Byte = slateBlue.B
    Dim r As Byte = slateBlue.R
    Dim a As Byte = slateBlue.A
    Dim text As String = _
    String.Format("Slate Blue has these ARGB values: Alpha:{0}, " _
       & "red:{1}, green: {2}, blue {3}", New Object() {a, r, g, b})
    e.Graphics.DrawString(text, New Font(Me.Font, FontStyle.Italic), _
        New SolidBrush(slateBlue), _
        New RectangleF(New PointF(0.0F, 0.0F), _
        Size.op_Implicit(Me.Size)))
End Sub

Remarks

Named colors are represented by using the properties of the Color structure.

The color of each pixel is represented as a 32-bit number: 8 bits each for alpha, red, green, and blue (ARGB). Each of the four components is a number from 0 through 255, with 0 representing no intensity and 255 representing full intensity. The alpha component specifies the transparency of the color: 0 is fully transparent, and 255 is fully opaque. To determine the alpha, red, green, or blue component of a color, use the A, R, G, or B property, respectively. You can create a custom color by using one of the FromArgb methods.

For more information about these colors, see List of colors by name.

Fields

Empty

Represents a color that is null.

Properties

A

Gets the alpha component value of this Color structure.

AliceBlue

Gets a system-defined color that has an ARGB value of #FFF0F8FF.

AntiqueWhite

Gets a system-defined color that has an ARGB value of #FFFAEBD7.

Aqua

Gets a system-defined color that has an ARGB value of #FF00FFFF.

Aquamarine

Gets a system-defined color that has an ARGB value of #FF7FFFD4.

Azure

Gets a system-defined color that has an ARGB value of #FFF0FFFF.

B

Gets the blue component value of this Color structure.

Beige

Gets a system-defined color that has an ARGB value of #FFF5F5DC.

Bisque

Gets a system-defined color that has an ARGB value of #FFFFE4C4.

Black

Gets a system-defined color that has an ARGB value of #FF000000.

BlanchedAlmond

Gets a system-defined color that has an ARGB value of #FFFFEBCD.

Blue

Gets a system-defined color that has an ARGB value of #FF0000FF.

BlueViolet

Gets a system-defined color that has an ARGB value of #FF8A2BE2.

Brown

Gets a system-defined color that has an ARGB value of #FFA52A2A.

BurlyWood

Gets a system-defined color that has an ARGB value of #FFDEB887.

CadetBlue

Gets a system-defined color that has an ARGB value of #FF5F9EA0.

Chartreuse

Gets a system-defined color that has an ARGB value of #FF7FFF00.

Chocolate

Gets a system-defined color that has an ARGB value of #FFD2691E.

Coral

Gets a system-defined color that has an ARGB value of #FFFF7F50.

CornflowerBlue

Gets a system-defined color that has an ARGB value of #FF6495ED.

Cornsilk

Gets a system-defined color that has an ARGB value of #FFFFF8DC.

Crimson

Gets a system-defined color that has an ARGB value of #FFDC143C.

Cyan

Gets a system-defined color that has an ARGB value of #FF00FFFF.

DarkBlue

Gets a system-defined color that has an ARGB value of #FF00008B.

DarkCyan

Gets a system-defined color that has an ARGB value of #FF008B8B.

DarkGoldenrod

Gets a system-defined color that has an ARGB value of #FFB8860B.

DarkGray

Gets a system-defined color that has an ARGB value of #FFA9A9A9.

DarkGreen

Gets a system-defined color that has an ARGB value of #FF006400.

DarkKhaki

Gets a system-defined color that has an ARGB value of #FFBDB76B.

DarkMagenta

Gets a system-defined color that has an ARGB value of #FF8B008B.

DarkOliveGreen

Gets a system-defined color that has an ARGB value of #FF556B2F.

DarkOrange

Gets a system-defined color that has an ARGB value of #FFFF8C00.

DarkOrchid

Gets a system-defined color that has an ARGB value of #FF9932CC.

DarkRed

Gets a system-defined color that has an ARGB value of #FF8B0000.

DarkSalmon

Gets a system-defined color that has an ARGB value of #FFE9967A.

DarkSeaGreen

Gets a system-defined color that has an ARGB value of #FF8FBC8B.

DarkSlateBlue

Gets a system-defined color that has an ARGB value of #FF483D8B.

DarkSlateGray

Gets a system-defined color that has an ARGB value of #FF2F4F4F.

DarkTurquoise

Gets a system-defined color that has an ARGB value of #FF00CED1.

DarkViolet

Gets a system-defined color that has an ARGB value of #FF9400D3.

DeepPink

Gets a system-defined color that has an ARGB value of #FFFF1493.

DeepSkyBlue

Gets a system-defined color that has an ARGB value of #FF00BFFF.

DimGray

Gets a system-defined color that has an ARGB value of #FF696969.

DodgerBlue

Gets a system-defined color that has an ARGB value of #FF1E90FF.

Firebrick

Gets a system-defined color that has an ARGB value of #FFB22222.

FloralWhite

Gets a system-defined color that has an ARGB value of #FFFFFAF0.

ForestGreen

Gets a system-defined color that has an ARGB value of #FF228B22.

Fuchsia

Gets a system-defined color that has an ARGB value of #FFFF00FF.

G

Gets the green component value of this Color structure.

Gainsboro

Gets a system-defined color that has an ARGB value of #FFDCDCDC.

GhostWhite

Gets a system-defined color that has an ARGB value of #FFF8F8FF.

Gold

Gets a system-defined color that has an ARGB value of #FFFFD700.

Goldenrod

Gets a system-defined color that has an ARGB value of #FFDAA520.

Gray

Gets a system-defined color that has an ARGB value of #FF808080.

Green

Gets a system-defined color that has an ARGB value of #FF008000.

GreenYellow

Gets a system-defined color that has an ARGB value of #FFADFF2F.

Honeydew

Gets a system-defined color that has an ARGB value of #FFF0FFF0.

HotPink

Gets a system-defined color that has an ARGB value of #FFFF69B4.

IndianRed

Gets a system-defined color that has an ARGB value of #FFCD5C5C.

Indigo

Gets a system-defined color that has an ARGB value of #FF4B0082.

IsEmpty

Specifies whether this Color structure is uninitialized.

IsKnownColor

Gets a value indicating whether this Color structure is a predefined color. Predefined colors are represented by the elements of the KnownColor enumeration.

IsNamedColor

Gets a value indicating whether this Color structure is a named color or a member of the KnownColor enumeration.

IsSystemColor

Gets a value indicating whether this Color structure is a system color. A system color is a color that is used in a Windows display element. System colors are represented by elements of the KnownColor enumeration.

Ivory

Gets a system-defined color that has an ARGB value of #FFFFFFF0.

Khaki

Gets a system-defined color that has an ARGB value of #FFF0E68C.

Lavender

Gets a system-defined color that has an ARGB value of #FFE6E6FA.

LavenderBlush

Gets a system-defined color that has an ARGB value of #FFFFF0F5.

LawnGreen

Gets a system-defined color that has an ARGB value of #FF7CFC00.

LemonChiffon

Gets a system-defined color that has an ARGB value of #FFFFFACD.

LightBlue

Gets a system-defined color that has an ARGB value of #FFADD8E6.

LightCoral

Gets a system-defined color that has an ARGB value of #FFF08080.

LightCyan

Gets a system-defined color that has an ARGB value of #FFE0FFFF.

LightGoldenrodYellow

Gets a system-defined color that has an ARGB value of #FFFAFAD2.

LightGray

Gets a system-defined color that has an ARGB value of #FFD3D3D3.

LightGreen

Gets a system-defined color that has an ARGB value of #FF90EE90.

LightPink

Gets a system-defined color that has an ARGB value of #FFFFB6C1.

LightSalmon

Gets a system-defined color that has an ARGB value of #FFFFA07A.

LightSeaGreen

Gets a system-defined color that has an ARGB value of #FF20B2AA.

LightSkyBlue

Gets a system-defined color that has an ARGB value of #FF87CEFA.

LightSlateGray

Gets a system-defined color that has an ARGB value of #FF778899.

LightSteelBlue

Gets a system-defined color that has an ARGB value of #FFB0C4DE.

LightYellow

Gets a system-defined color that has an ARGB value of #FFFFFFE0.

Lime

Gets a system-defined color that has an ARGB value of #FF00FF00.

LimeGreen

Gets a system-defined color that has an ARGB value of #FF32CD32.

Linen

Gets a system-defined color that has an ARGB value of #FFFAF0E6.

Magenta

Gets a system-defined color that has an ARGB value of #FFFF00FF.

Maroon

Gets a system-defined color that has an ARGB value of #FF800000.

MediumAquamarine

Gets a system-defined color that has an ARGB value of #FF66CDAA.

MediumBlue

Gets a system-defined color that has an ARGB value of #FF0000CD.

MediumOrchid

Gets a system-defined color that has an ARGB value of #FFBA55D3.

MediumPurple

Gets a system-defined color that has an ARGB value of #FF9370DB.

MediumSeaGreen

Gets a system-defined color that has an ARGB value of #FF3CB371.

MediumSlateBlue

Gets a system-defined color that has an ARGB value of #FF7B68EE.

MediumSpringGreen

Gets a system-defined color that has an ARGB value of #FF00FA9A.

MediumTurquoise

Gets a system-defined color that has an ARGB value of #FF48D1CC.

MediumVioletRed

Gets a system-defined color that has an ARGB value of #FFC71585.

MidnightBlue

Gets a system-defined color that has an ARGB value of #FF191970.

MintCream

Gets a system-defined color that has an ARGB value of #FFF5FFFA.

MistyRose

Gets a system-defined color that has an ARGB value of #FFFFE4E1.

Moccasin

Gets a system-defined color that has an ARGB value of #FFFFE4B5.

Name

Gets the name of this Color.

NavajoWhite

Gets a system-defined color that has an ARGB value of #FFFFDEAD.

Navy

Gets a system-defined color that has an ARGB value of #FF000080.

OldLace

Gets a system-defined color that has an ARGB value of #FFFDF5E6.

Olive

Gets a system-defined color that has an ARGB value of #FF808000.

OliveDrab

Gets a system-defined color that has an ARGB value of #FF6B8E23.

Orange

Gets a system-defined color that has an ARGB value of #FFFFA500.

OrangeRed

Gets a system-defined color that has an ARGB value of #FFFF4500.

Orchid

Gets a system-defined color that has an ARGB value of #FFDA70D6.

PaleGoldenrod

Gets a system-defined color that has an ARGB value of #FFEEE8AA.

PaleGreen

Gets a system-defined color that has an ARGB value of #FF98FB98.

PaleTurquoise

Gets a system-defined color that has an ARGB value of #FFAFEEEE.

PaleVioletRed

Gets a system-defined color that has an ARGB value of #FFDB7093.

PapayaWhip

Gets a system-defined color that has an ARGB value of #FFFFEFD5.

PeachPuff

Gets a system-defined color that has an ARGB value of #FFFFDAB9.

Peru

Gets a system-defined color that has an ARGB value of #FFCD853F.

Pink

Gets a system-defined color that has an ARGB value of #FFFFC0CB.

Plum

Gets a system-defined color that has an ARGB value of #FFDDA0DD.

PowderBlue

Gets a system-defined color that has an ARGB value of #FFB0E0E6.

Purple

Gets a system-defined color that has an ARGB value of #FF800080.

R

Gets the red component value of this Color structure.

RebeccaPurple

Gets a system-defined color that has an ARGB value of #663399.

Red

Gets a system-defined color that has an ARGB value of #FFFF0000.

RosyBrown

Gets a system-defined color that has an ARGB value of #FFBC8F8F.

RoyalBlue

Gets a system-defined color that has an ARGB value of #FF4169E1.

SaddleBrown

Gets a system-defined color that has an ARGB value of #FF8B4513.

Salmon

Gets a system-defined color that has an ARGB value of #FFFA8072.

SandyBrown

Gets a system-defined color that has an ARGB value of #FFF4A460.

SeaGreen

Gets a system-defined color that has an ARGB value of #FF2E8B57.

SeaShell

Gets a system-defined color that has an ARGB value of #FFFFF5EE.

Sienna

Gets a system-defined color that has an ARGB value of #FFA0522D.

Silver

Gets a system-defined color that has an ARGB value of #FFC0C0C0.

SkyBlue

Gets a system-defined color that has an ARGB value of #FF87CEEB.

SlateBlue

Gets a system-defined color that has an ARGB value of #FF6A5ACD.

SlateGray

Gets a system-defined color that has an ARGB value of #FF708090.

Snow

Gets a system-defined color that has an ARGB value of #FFFFFAFA.

SpringGreen

Gets a system-defined color that has an ARGB value of #FF00FF7F.

SteelBlue

Gets a system-defined color that has an ARGB value of #FF4682B4.

Tan

Gets a system-defined color that has an ARGB value of #FFD2B48C.

Teal

Gets a system-defined color that has an ARGB value of #FF008080.

Thistle

Gets a system-defined color that has an ARGB value of #FFD8BFD8.

Tomato

Gets a system-defined color that has an ARGB value of #FFFF6347.

Transparent

Gets a system-defined color.

Turquoise

Gets a system-defined color that has an ARGB value of #FF40E0D0.

Violet

Gets a system-defined color that has an ARGB value of #FFEE82EE.

Wheat

Gets a system-defined color that has an ARGB value of #FFF5DEB3.

White

Gets a system-defined color that has an ARGB value of #FFFFFFFF.

WhiteSmoke

Gets a system-defined color that has an ARGB value of #FFF5F5F5.

Yellow

Gets a system-defined color that has an ARGB value of #FFFFFF00.

YellowGreen

Gets a system-defined color that has an ARGB value of #FF9ACD32.

Methods

Equals(Color)

Indicates whether the current object is equal to another object of the same type.

Equals(Object)

Tests whether the specified object is a Color structure and is equivalent to this Color structure.

FromArgb(Int32)

Creates a Color structure from a 32-bit ARGB value.

FromArgb(Int32, Color)

Creates a Color structure from the specified Color structure, but with the new specified alpha value. Although this method allows a 32-bit value to be passed for the alpha value, the value is limited to 8 bits.

FromArgb(Int32, Int32, Int32)

Creates a Color structure from the specified 8-bit color values (red, green, and blue). The alpha value is implicitly 255 (fully opaque). Although this method allows a 32-bit value to be passed for each color component, the value of each component is limited to 8 bits.

FromArgb(Int32, Int32, Int32, Int32)

Creates a Color structure from the four ARGB component (alpha, red, green, and blue) values. Although this method allows a 32-bit value to be passed for each component, the value of each component is limited to 8 bits.

FromKnownColor(KnownColor)

Creates a Color structure from the specified predefined color.

FromName(String)

Creates a Color structure from the specified name of a predefined color.

GetBrightness()

Gets the hue-saturation-lightness (HSL) lightness value for this Color structure.

GetHashCode()

Returns a hash code for this Color structure.

GetHue()

Gets the hue-saturation-lightness (HSL) hue value, in degrees, for this Color structure.

GetSaturation()

Gets the hue-saturation-lightness (HSL) saturation value for this Color structure.

ToArgb()

Gets the 32-bit ARGB value of this Color structure.

ToKnownColor()

Gets the KnownColor value of this Color structure.

ToString()

Converts this Color structure to a human-readable string.

Operators

Equality(Color, Color)

Tests whether two specified Color structures are equivalent.

Inequality(Color, Color)

Tests whether two specified Color structures are different.

Applies to

See also