Color::SetFromCOLORREF 方法 (gdipluscolor.h)

Color::SetFromCOLORREF 方法會使用 Windows 圖形裝置介面 (GDI) COLORREF 值來設定此 Color 物件的 ARGB 值。

語法

void SetFromCOLORREF(
  [in] COLORREF rgb
);

參數

[in] rgb

類型: COLORREF

GDI COLORREF 值,指定此 Color 物件 ARGB 值的紅色、綠色和藍色元件。 這個 Color 物件的 Alpha 元件預設值為 255。

傳回值

備註

32 位 GDI COLORREF 值包含三個 8 位色彩元件。 最重要的8位是零,且未使用、下一個8位包含藍色元件、下一個8位包含綠色元件,最後8個位 (最小有效) 包含紅色元件。 請注意,從 COLORREF 值中元件的高階位) 開始排序 (為藍色、綠色、紅色;而 ARGB 值的排序是 Alpha、紅色、綠色、藍色。

範例

下列範例會建立 Color 物件,並設定 GDI COLORREF 值。 然後程式代碼會將 Color 物件設定為 GDI COLORREF 值的值、建立畫筆,並繪製線條。

VOID Example_SetFromCOLORREF(HDC hdc)
{
   Graphics graphics(hdc);

   // Create a color object.
   Color gdipColor(255, 0, 0, 255);

   // COLORREF is defined as an unsigned long in Wingdi.h
   unsigned long gdiColorRef = RGB(0, 0, 0);   // Set a GDI COLORREF value.

   // Set the color object to the COLORREF value.
   gdipColor.SetFromCOLORREF(gdiColorRef);

   // Create a Pen object based on the Color object.
   Pen pen((gdipColor), 10);

   // Draw a line.
   graphics.DrawLine(&pen, 0, 0, 200, 100);
}

規格需求

需求
最低支援的用戶端 Windows XP、Windows 2000 Professional [僅限桌面應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 gdipluscolor.h (包含 Gdiplus.h)
程式庫 Gdiplus.lib
Dll Gdiplus.dll

另請參閱

色彩

Color::MakeARGB

Color::ToCOLORREF