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 |