Color Struct

Definition

Namespace:: System.Drawing

Assembly:: System.Drawing.Primitives.dll

Assembly:: System.Drawing.dll

Assembly:: netstandard.dll

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

public value class Color : IEquatable<System::Drawing::Color>

public value class Color

public 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

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: Object

ValueType
Color

Attributes: TypeConverterAttribute ComVisibleAttribute SerializableAttribute

Implements: IEquatable<Color>

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. For more information about these colors, see Colors by Name.

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.

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.
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.