Color 結構

參考

定義

命名空間:: System.Drawing

組件:: System.Drawing.Primitives.dll

組件:: System.Drawing.dll

組件:: netstandard.dll

來源:: Color.cs

來源:: Color.cs

來源:: Color.cs

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

表示 ARGB (Alpha、紅、綠、藍) 色彩。

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

繼承: Object

ValueType
Color

屬性: TypeConverterAttribute ComVisibleAttribute SerializableAttribute

實作: IEquatable<Color>

範例

下列程式代碼範例示範A、 R和成員的Color、 G和 B Implicit 屬性。

此範例的設計目的是要與 Windows Form 搭配使用。將程式代碼貼到表單中，並從表單的事件Paint處理方法呼叫 ShowPropertiesOfSlateBlue 方法，並傳遞e為 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

備註

具名色彩是使用結構的屬性 Color 來表示。

每個圖元的色彩會以 32 位的數位表示：8 位代表 alpha、紅色、綠色和藍色 (ARGB) 。四個元件中的每一個都是從 0 到 255 的數位，0 代表無濃度，255 代表完整濃度。 Alpha元件會指定色彩的透明度：0 完全透明，而 255 則完全不透明。若要判斷色彩的 Alpha、紅色、綠色或藍色元件，請分別使用 A、 R、 G或 B 屬性。您可以使用其中 FromArgb 一種方法來建立自訂色彩。

如需這些色彩的詳細資訊，請參閱依名稱列出色彩。

欄位

Empty

表示為 null 的色彩。

屬性

A	取得這個 Color 結構的 Alpha 元件值。
AliceBlue	取得系統定義的色彩，此色彩具有的 `#FFF0F8FF`ARGB值。
AntiqueWhite	取得系統定義的色彩，此色彩具有的 `#FFFAEBD7`ARGB值。
Aqua	取得系統定義的色彩，此色彩具有的 `#FF00FFFF`ARGB值。
Aquamarine	取得系統定義的色彩，此色彩具有的 `#FF7FFFD4`ARGB值。
Azure	取得系統定義的色彩，此色彩具有的 `#FFF0FFFF`ARGB值。
B	取得這個 Color 結構的藍色元件值。
Beige	取得系統定義的色彩，此色彩具有的 `#FFF5F5DC`ARGB值。
Bisque	取得系統定義的色彩，此色彩具有的 `#FFFFE4C4`ARGB值。
Black	取得系統定義的色彩，此色彩具有的 `#FF000000`ARGB值。
BlanchedAlmond	取得系統定義的色彩，此色彩具有的 `#FFFFEBCD`ARGB值。
Blue	取得系統定義的色彩，此色彩具有的 `#FF0000FF`ARGB值。
BlueViolet	取得系統定義的色彩，此色彩具有的 `#FF8A2BE2`ARGB值。
Brown	取得系統定義的色彩，此色彩具有的 `#FFA52A2A`ARGB值。
BurlyWood	取得系統定義的色彩，此色彩具有的 `#FFDEB887`ARGB值。
CadetBlue	取得系統定義的色彩，此色彩具有的 `#FF5F9EA0`ARGB值。
Chartreuse	取得系統定義的色彩，此色彩具有的 `#FF7FFF00`ARGB值。
Chocolate	取得系統定義的色彩，此色彩具有的 `#FFD2691E`ARGB值。
Coral	取得系統定義的色彩，此色彩具有的 `#FFFF7F50`ARGB值。
CornflowerBlue	取得系統定義的色彩，此色彩具有的 `#FF6495ED`ARGB值。
Cornsilk	取得系統定義的色彩，此色彩具有的 `#FFFFF8DC`ARGB值。
Crimson	取得系統定義的色彩，此色彩具有的 `#FFDC143C`ARGB值。
Cyan	取得系統定義的色彩，此色彩具有的 `#FF00FFFF`ARGB值。
DarkBlue	取得系統定義的色彩，此色彩具有的 `#FF00008B`ARGB值。
DarkCyan	取得系統定義的色彩，此色彩具有的 `#FF008B8B`ARGB值。
DarkGoldenrod	取得系統定義的色彩，此色彩具有的 `#FFB8860B`ARGB值。
DarkGray	取得系統定義的色彩，此色彩具有的 `#FFA9A9A9`ARGB值。
DarkGreen	取得系統定義的色彩，此色彩具有的 `#FF006400`ARGB值。
DarkKhaki	取得系統定義的色彩，此色彩具有的 `#FFBDB76B`ARGB值。
DarkMagenta	取得系統定義的色彩，此色彩具有的 `#FF8B008B`ARGB值。
DarkOliveGreen	取得系統定義的色彩，此色彩具有的 `#FF556B2F`ARGB值。
DarkOrange	取得系統定義的色彩，此色彩具有的 `#FFFF8C00`ARGB值。
DarkOrchid	取得系統定義的色彩，此色彩具有的 `#FF9932CC`ARGB值。
DarkRed	取得系統定義的色彩，此色彩具有的 `#FF8B0000`ARGB值。
DarkSalmon	取得系統定義的色彩，此色彩具有的 `#FFE9967A`ARGB值。
DarkSeaGreen	取得系統定義的色彩，此色彩具有的 `#FF8FBC8B`ARGB值。
DarkSlateBlue	取得系統定義的色彩，此色彩具有的 `#FF483D8B`ARGB值。
DarkSlateGray	取得系統定義的色彩，此色彩具有的 `#FF2F4F4F`ARGB值。
DarkTurquoise	取得系統定義的色彩，此色彩具有的 `#FF00CED1`ARGB值。
DarkViolet	取得系統定義的色彩，此色彩具有的 `#FF9400D3`ARGB值。
DeepPink	取得系統定義的色彩，此色彩具有的 `#FFFF1493`ARGB值。
DeepSkyBlue	取得系統定義的色彩，此色彩具有的 `#FF00BFFF`ARGB值。
DimGray	取得系統定義的色彩，此色彩具有的 `#FF696969`ARGB值。
DodgerBlue	取得系統定義的色彩，此色彩具有的 `#FF1E90FF`ARGB值。
Firebrick	取得系統定義的色彩，此色彩具有的 `#FFB22222`ARGB值。
FloralWhite	取得系統定義的色彩，此色彩具有的 `#FFFFFAF0`ARGB值。
ForestGreen	取得系統定義的色彩，此色彩具有的 `#FF228B22`ARGB值。
Fuchsia	取得系統定義的色彩，此色彩具有的 `#FFFF00FF`ARGB值。
G	取得這個 Color 結構的綠色元件值。
Gainsboro	取得系統定義的色彩，此色彩具有的 `#FFDCDCDC`ARGB值。
GhostWhite	取得系統定義的色彩，此色彩具有的 `#FFF8F8FF`ARGB值。
Gold	取得系統定義的色彩，此色彩具有的 `#FFFFD700`ARGB值。
Goldenrod	取得系統定義的色彩，此色彩具有的 `#FFDAA520`ARGB值。
Gray	取得系統定義的色彩，此色彩具有的 `#FF808080`ARGB值。
Green	取得系統定義的色彩，此色彩具有的 `#FF008000`ARGB值。
GreenYellow	取得系統定義的色彩，此色彩具有的 `#FFADFF2F`ARGB值。
Honeydew	取得系統定義的色彩，此色彩具有的 `#FFF0FFF0`ARGB值。
HotPink	取得系統定義的色彩，此色彩具有的 `#FFFF69B4`ARGB值。
IndianRed	取得系統定義的色彩，此色彩具有的 `#FFCD5C5C`ARGB值。
Indigo	取得系統定義的色彩，此色彩具有的 `#FF4B0082`ARGB值。
IsEmpty	指定這個 Color 結構是否未初始化。
IsKnownColor	取得值，指出這個 Color 結構是否為預先定義的色彩。預先定義的色彩是由 KnownColor 列舉型別的項目所表示。
IsNamedColor	取得值，指出這個 Color 結構是否為命名色彩，或是 KnownColor 列舉型別的成員。
IsSystemColor	取得值，指出這個 Color 結構是否為系統色彩。系統色彩是用於 Windows 顯示項目的色彩。系統色彩是由 KnownColor 列舉型別的元素所表示。
Ivory	取得系統定義的色彩，此色彩具有的 `#FFFFFFF0`ARGB值。
Khaki	取得系統定義的色彩，此色彩具有的 `#FFF0E68C`ARGB值。
Lavender	取得系統定義的色彩，此色彩具有的 `#FFE6E6FA`ARGB值。
LavenderBlush	取得系統定義的色彩，此色彩具有的 `#FFFFF0F5`ARGB值。
LawnGreen	取得系統定義的色彩，此色彩具有的 `#FF7CFC00`ARGB值。
LemonChiffon	取得系統定義的色彩，此色彩具有的 `#FFFFFACD`ARGB值。
LightBlue	取得系統定義的色彩，此色彩具有的 `#FFADD8E6`ARGB值。
LightCoral	取得系統定義的色彩，此色彩具有的 `#FFF08080`ARGB值。
LightCyan	取得系統定義的色彩，此色彩具有的 `#FFE0FFFF`ARGB值。
LightGoldenrodYellow	取得系統定義的色彩，此色彩具有的 `#FFFAFAD2`ARGB值。
LightGray	取得系統定義的色彩，此色彩具有的 `#FFD3D3D3`ARGB值。
LightGreen	取得系統定義的色彩，此色彩具有的 `#FF90EE90`ARGB值。
LightPink	取得系統定義的色彩，此色彩具有的 `#FFFFB6C1`ARGB值。
LightSalmon	取得系統定義的色彩，此色彩具有的 `#FFFFA07A`ARGB值。
LightSeaGreen	取得系統定義的色彩，此色彩具有的 `#FF20B2AA`ARGB值。
LightSkyBlue	取得系統定義的色彩，此色彩具有的 `#FF87CEFA`ARGB值。
LightSlateGray	取得系統定義的色彩，此色彩具有的 `#FF778899`ARGB值。
LightSteelBlue	取得系統定義的色彩，此色彩具有的 `#FFB0C4DE`ARGB值。
LightYellow	取得系統定義的色彩，此色彩具有的 `#FFFFFFE0`ARGB值。
Lime	取得系統定義的色彩，此色彩具有的 `#FF00FF00`ARGB值。
LimeGreen	取得系統定義的色彩，此色彩具有的 `#FF32CD32`ARGB值。
Linen	取得系統定義的色彩，此色彩具有的 `#FFFAF0E6`ARGB值。
Magenta	取得系統定義的色彩，此色彩具有的 `#FFFF00FF`ARGB值。
Maroon	取得系統定義的色彩，此色彩具有的 `#FF800000`ARGB值。
MediumAquamarine	取得系統定義的色彩，此色彩具有的 `#FF66CDAA`ARGB值。
MediumBlue	取得系統定義的色彩，此色彩具有的 `#FF0000CD`ARGB值。
MediumOrchid	取得系統定義的色彩，此色彩具有的 `#FFBA55D3`ARGB值。
MediumPurple	取得系統定義的色彩，此色彩具有的 `#FF9370DB`ARGB值。
MediumSeaGreen	取得系統定義的色彩，此色彩具有的 `#FF3CB371`ARGB值。
MediumSlateBlue	取得系統定義的色彩，此色彩具有的 `#FF7B68EE`ARGB值。
MediumSpringGreen	取得系統定義的色彩，此色彩具有的 `#FF00FA9A`ARGB值。
MediumTurquoise	取得系統定義的色彩，此色彩具有的 `#FF48D1CC`ARGB值。
MediumVioletRed	取得系統定義的色彩，此色彩具有的 `#FFC71585`ARGB值。
MidnightBlue	取得系統定義的色彩，此色彩具有的 `#FF191970`ARGB值。
MintCream	取得系統定義的色彩，此色彩具有的 `#FFF5FFFA`ARGB值。
MistyRose	取得系統定義的色彩，此色彩具有的 `#FFFFE4E1`ARGB值。
Moccasin	取得系統定義的色彩，此色彩具有的 `#FFFFE4B5`ARGB值。
Name	取得這個 Color 的名稱。
NavajoWhite	取得系統定義的色彩，此色彩具有的 `#FFFFDEAD`ARGB值。
Navy	取得系統定義的色彩，此色彩具有的 `#FF000080`ARGB值。
OldLace	取得系統定義的色彩，此色彩具有的 `#FFFDF5E6`ARGB值。
Olive	取得系統定義的色彩，此色彩具有的 `#FF808000`ARGB值。
OliveDrab	取得系統定義的色彩，此色彩具有的 `#FF6B8E23`ARGB值。
Orange	取得系統定義的色彩，此色彩具有的 `#FFFFA500`ARGB值。
OrangeRed	取得系統定義的色彩，此色彩具有的 `#FFFF4500`ARGB值。
Orchid	取得系統定義的色彩，此色彩具有的 `#FFDA70D6`ARGB值。
PaleGoldenrod	取得系統定義的色彩，此色彩具有的 `#FFEEE8AA`ARGB值。
PaleGreen	取得系統定義的色彩，此色彩具有的 `#FF98FB98`ARGB值。
PaleTurquoise	取得系統定義的色彩，此色彩具有的 `#FFAFEEEE`ARGB值。
PaleVioletRed	取得系統定義的色彩，此色彩具有的 `#FFDB7093`ARGB值。
PapayaWhip	取得系統定義的色彩，此色彩具有的 `#FFFFEFD5`ARGB值。
PeachPuff	取得系統定義的色彩，此色彩具有的 `#FFFFDAB9`ARGB值。
Peru	取得系統定義的色彩，此色彩具有的 `#FFCD853F`ARGB值。
Pink	取得系統定義的色彩，此色彩具有的 `#FFFFC0CB`ARGB值。
Plum	取得系統定義的色彩，此色彩具有的 `#FFDDA0DD`ARGB值。
PowderBlue	取得系統定義的色彩，此色彩具有的 `#FFB0E0E6`ARGB值。
Purple	取得系統定義的色彩，此色彩具有的 `#FF800080`ARGB值。
R	取得這個 Color 結構的紅色元件值。
RebeccaPurple	取得系統定義的色彩，此色彩具有的 `#663399`ARGB值。
Red	取得系統定義的色彩，此色彩具有的 `#FFFF0000`ARGB值。
RosyBrown	取得系統定義的色彩，此色彩具有的 `#FFBC8F8F`ARGB值。
RoyalBlue	取得系統定義的色彩，此色彩具有的 `#FF4169E1`ARGB值。
SaddleBrown	取得系統定義的色彩，此色彩具有的 `#FF8B4513`ARGB值。
Salmon	取得系統定義的色彩，此色彩具有的 `#FFFA8072`ARGB值。
SandyBrown	取得系統定義的色彩，此色彩具有的 `#FFF4A460`ARGB值。
SeaGreen	取得系統定義的色彩，此色彩具有的 `#FF2E8B57`ARGB值。
SeaShell	取得系統定義的色彩，此色彩具有的 `#FFFFF5EE`ARGB值。
Sienna	取得系統定義的色彩，此色彩具有的 `#FFA0522D`ARGB值。
Silver	取得系統定義的色彩，此色彩具有的 `#FFC0C0C0`ARGB值。
SkyBlue	取得系統定義的色彩，此色彩具有的 `#FF87CEEB`ARGB值。
SlateBlue	取得系統定義的色彩，此色彩具有的 `#FF6A5ACD`ARGB值。
SlateGray	取得系統定義的色彩，此色彩具有的 `#FF708090`ARGB值。
Snow	取得系統定義的色彩，此色彩具有的 `#FFFFFAFA`ARGB值。
SpringGreen	取得系統定義的色彩，此色彩具有的 `#FF00FF7F`ARGB值。
SteelBlue	取得系統定義的色彩，此色彩具有的 `#FF4682B4`ARGB值。
Tan	取得系統定義的色彩，此色彩具有的 `#FFD2B48C`ARGB值。
Teal	取得系統定義的色彩，此色彩具有的 `#FF008080`ARGB值。
Thistle	取得系統定義的色彩，此色彩具有的 `#FFD8BFD8`ARGB值。
Tomato	取得系統定義的色彩，此色彩具有的 `#FFFF6347`ARGB值。
Transparent	取得系統定義的色彩。
Turquoise	取得系統定義的色彩，此色彩具有的 `#FF40E0D0`ARGB值。
Violet	取得系統定義的色彩，此色彩具有的 `#FFEE82EE`ARGB值。
Wheat	取得系統定義的色彩，此色彩具有的 `#FFF5DEB3`ARGB值。
White	取得系統定義的色彩，此色彩具有的 `#FFFFFFFF`ARGB值。
WhiteSmoke	取得系統定義的色彩，此色彩具有的 `#FFF5F5F5`ARGB值。
Yellow	取得系統定義的色彩，此色彩具有的 `#FFFFFF00`ARGB值。
YellowGreen	取得系統定義的色彩，此色彩具有的 `#FF9ACD32`ARGB值。

方法

Equals(Color)	指出目前的物件是否等於另一個相同類型的物件。
Equals(Object)	測試指定的物件是否為 Color 結構，並且和這個 Color 結構相等。
FromArgb(Int32)	從 32 位元的 ARGB 值建立 Color 結構。
FromArgb(Int32, Color)	從指定的 Color 結構 (但是使用新指定的 Alpha 值) 建立 Color 結構。雖然這個方法允許為 Alpha 值傳遞 32 位元值，但是該值是限制為 8 位元。
FromArgb(Int32, Int32, Int32)	從指定的 8 位元色彩值 (紅、綠和藍) 建立 Color 結構。 Alpha 值隱含為 255 (完全不透明)。雖然這個方法允許為每個色彩元件傳遞 32 位元值，但是每個元件的值是限制為 8 位元。
FromArgb(Int32, Int32, Int32, Int32)	從四個 ARGB 元件 (Alpha、紅、綠和藍) 值建立 Color 結構。雖然這個方法允許為每個元件傳遞 32 位元值，但是每個元件的值是限制為 8 位元。
FromKnownColor(KnownColor)	從指定的預先定義色彩建立 Color 結構。
FromName(String)	從指定的預先定義色彩名稱建立 Color 結構。
GetBrightness()	取得這個 Color 結構的色相-彩度-亮度 (HSL) 的亮度值。
GetHashCode()	傳回這個 Color 結構的雜湊程式碼。
GetHue()	取得這個 Color 結構的色相-彩度-亮度 (HSL) 的色相值，單位為度。
GetSaturation()	取得這個 Color 結構的色相-彩度-亮度 (HSL) 的彩度值。
ToArgb()	取得這個 Color 結構的 32 位元 ARGB 值。
ToKnownColor()	取得這個 KnownColor 結構的 Color 值。
ToString()	將這個 Color 結構轉換為人們可讀取的 (Human-Readable) 字串。

運算子

Equality(Color, Color)	測試兩個指定的 Color 結構是否相等。
Inequality(Color, Color)	測試兩個指定的 Color 結構是否不同。

適用於

產品	版本
.NET	Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

另請參閱

將影像重新著色

共用方式為

Color 結構

定義

範例

備註

欄位

屬性

方法

運算子

適用於

另請參閱

其他資源