Freigeben über


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