Share via

Color::SetFromCOLORREF-Methode (gdipluscolor.h)

  • Artikel

Die Color::SetFromCOLORREF-Methode verwendet einen Windows Graphics Device Interface (GDI)COLORREF-Wert , um den ARGB-Wert dieses Color-Objekts festzulegen.

Syntax

void SetFromCOLORREF(
  [in] COLORREF rgb
);

Parameter

[in] rgb

Typ: COLORREF

GDI COLORREF-Wert, der die roten, grünen und blauen Komponenten des ARGB-Werts dieses Color-Objekts angibt. Der Standardwert der Alphakomponente für dieses Color-Objekt ist 255.

Rückgabewert

Keine

Bemerkungen

Ein 32-Bit-GDI COLORREF-Wert enthält drei 8-Bit-Farbkomponenten. Die wichtigsten 8 Bits sind Nullen und werden nicht verwendet, die nächsten 8 Bits enthalten die blaue Komponente, die nächsten 8 Bits die grüne Komponente und die letzten 8 Bits (die am wenigsten signifikanteste) enthalten die rote Komponente. Beachten Sie, dass die Reihenfolge (beginnend mit den Bits hoher Reihenfolge) der Komponenten in einem COLORREF-Wert blau, grün, rot ist. Während die Reihenfolge eines ARGB-Werts alpha, rot, grün, blau ist.

Beispiele

Im folgenden Beispiel wird ein Color-Objekt erstellt und ein GDI COLORREF-Wert festgelegt. Der Code legt dann das Color-Objekt auf den Wert des GDI COLORREF-Werts fest, erstellt einen Stift und zeichnet eine Linie.

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);
}

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile gdipluscolor.h (include Gdiplus.h)
Bibliothek Gdiplus.lib
DLL Gdiplus.dll

Weitere Informationen

Farbe

Color::MakeARGB

Farbe::ToCOLORREF