SetDCPenColor-Funktion (wingdi.h)
Die SetDCPenColor-Funktion legt die aktuelle Stiftfarbe des Gerätekontexts (DC) auf den angegebenen Farbwert fest. Wenn das Gerät den angegebenen Farbwert nicht darstellen kann, wird die Farbe auf die nächste physische Farbe festgelegt.
Syntax
COLORREF SetDCPenColor(
[in] HDC hdc,
[in] COLORREF color
);
Parameter
[in] hdc
Ein Handle für den DC.
[in] color
Die neue Stiftfarbe.
Rückgabewert
Wenn die Funktion erfolgreich ist, gibt der Rückgabewert die vorherige DC-Stiftfarbe als COLORREF-Wert an. Wenn die Funktion fehlerhaft ist, ist der Rückgabewert CLR_INVALID.
Hinweise
Die Funktion gibt die vorherige DC_PEN Farbe zurück, auch wenn der Stift DC_PEN im DC nicht ausgewählt ist. Dies wird jedoch erst dann in Zeichnungsvorgängen verwendet, wenn der Lagerbestand DC_PEN im DC ausgewählt ist.
Die GetStockObject-Funktion mit dem Argument DC_BRUSH oder DC_PEN kann austauschbar mit den Funktionen SetDCPenColor und SetDCBrushColor verwendet werden.
ICM: Die Farbverwaltung wird ausgeführt, wenn ICM aktiviert ist.
Beispiele
Ein Beispiel für das Festlegen von Farben finden Sie unter Festlegen der Stift- oder Pinselfarbe.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | wingdi.h (windows.h einschließen) |
| Bibliothek | Gdi32.lib |
| DLL | Gdi32.dll |