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

Weitere Informationen

COLORREF

Gerätekontextfunktionen

Übersicht über Gerätekontexte

GetDCPenColor