Color::SetFromCOLORREF-Methode (gdipluscolor.h)
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 |