Color class (gdipluscolor.h)
A Color object stores a 32-bit value that represents a color. The color value contains four, 8-bit components: alpha, red, green, and blue. The first 8 bits (the most significant) contain the alpha component, the next 8 bits contain the red component, the next 8 bits contain the green component, and the next 8 bits (the least significant) contain the blue component. The 32-bit value is stored in a variable of type ARGB.
Methods
The Color class has these methods.
| Color::Color Creates a Color::Color object and initializes it to opaque black. This is the default constructor. |
| Color::Color Creates a Color::Color object by using an ARGB value. |
| Color::Color Creates a Color::Color object by using specified values for the red, green, and blue components. This constructor sets the alpha component to 255 (opaque). |
| Color::Color Creates a Color::Color object by using specified values for the alpha, red, green, and blue components. |
| Color::GetA The Color::GetA method gets the alpha component of this Color object. |
| Color::GetAlpha The Color::GetAlpha method gets the alpha component of this Color object. |
| Color::GetB The Color::GetB method gets the blue component of this Color object. |
| Color::GetBlue The Color::GetBlue method gets the blue component of this Color object. |
| Color::GetG The Color::GetG method gets the green component of this Color object. |
| Color::GetGreen The Color::GetGreen method gets the green component of this Color object. |
| Color::GetR The Color::GetR method gets the red component of this Color object. |
| Color::GetRed The Color::GetRed method gets the red component of this Color object. |
| Color::GetValue The Color::GetValue method gets the ARGB value of this Color object. |
| Color::MakeARGB The Color::MakeARGB method creates a 32-bit value that consolidates the specified alpha, red, green, and blue components. |
| Color::SetFromCOLORREF The Color::SetFromCOLORREF method uses a Windows Graphics Device Interface (GDI)COLORREF value to set the ARGB value of this Color object. |
| Color::SetValue The Color::SetValue method sets the color of this Color object. |
| Color::ToCOLORREF The Color::ToCOLORREF method converts this Color object's ARGB value to a Windows Graphics Device Interface (GDI)COLORREF value. |
Remarks
The alpha component, the most significant 8 bits, specifies the transparency of a color. All four component values range from 0 to 255. An alpha component value of 0 specifies that the color is transparent, and an alpha value of 255 specifies that the color is opaque. Alpha component values from 1 through 254 specify the degree to which the color is blended with the background when the color is rendered. The red, green, and blue color component values range from 0 to 255 and determine the intensity of the color. The Color::MakeARGB method is used to encapsulate the four color components into a single 32-bit value.
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Windows |
| Header | gdipluscolor.h |