SetDCBrushColor-Funktion (wingdi.h)

Die SetDCBrushColor-Funktion legt die Pinselfarbe des aktuellen 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 SetDCBrushColor(
  [in] HDC      hdc,
  [in] COLORREF color
);

Parameter

[in] hdc

Ein Handle für den DC.

[in] color

Die neue Pinselfarbe.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt der Rückgabewert die vorherige DC-Pinselfarbe als COLORREF-Wert an.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert CLR_INVALID.

Hinweise

Wenn der Lagerbestand DC_BRUSH in einem DC ausgewählt ist, werden alle nachfolgenden Zeichnungen mit der DC-Pinselfarbe ausgeführt, bis der Standardpinsel deaktiviert ist. Die Standardfarbe DC_BRUSH ist WEIß.

Die Funktion gibt die vorherige DC_BRUSH Farbe zurück, auch wenn der Stockpinsel DC_BRUSH im DC nicht ausgewählt ist. Dies wird jedoch in Zeichnungsvorgängen erst verwendet, wenn die DC_BRUSH 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

GetDCBrushColor