تحرير

مشاركة عبر

Color Struct

  • Reference

Definition

Namespace:
System.Drawing
Assembly:
System.Drawing.Primitives.dll
Assembly:
System.Drawing.dll
Assembly:
netstandard.dll
Source:
Color.cs
Source:
Color.cs
Source:
Color.cs

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

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