SetBkColor-Funktion (wingdi.h)
Die SetBkColor-Funktion legt die aktuelle Hintergrundfarbe auf den angegebenen Farbwert oder auf die nächste physische Farbe fest, wenn das Gerät den angegebenen Farbwert nicht darstellen kann.
Syntax
COLORREF SetBkColor(
[in] HDC hdc,
[in] COLORREF color
);
Parameter
[in] hdc
Ein Handle für den Gerätekontext.
[in] color
Die neue Hintergrundfarbe. Verwenden Sie das RGB-Makro, um einen COLORREF-Wert zu erstellen.
Rückgabewert
Wenn die Funktion erfolgreich ist, gibt der Rückgabewert die vorherige Hintergrundfarbe als COLORREF-Wert an.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert CLR_INVALID.
Hinweise
Diese Funktion füllt die Lücken zwischen formatierten Linien, die mit einem Stift gezeichnet wurden, der von der CreatePen-Funktion erstellt wurde. Es schließt die Lücken zwischen formatierten Linien, die mit einem Stift gezeichnet wurden, der von der ExtCreatePen-Funktion erstellt wurde. Die SetBkColor-Funktion legt auch die Hintergrundfarben für TextOut und ExtTextOut fest.
Wenn der Hintergrundmodus OPAQUE ist, wird die Hintergrundfarbe verwendet, um Lücken zwischen formatierten Linien, Lücken zwischen geschlüpften Linien in Pinsel und Zeichenzellen zu füllen. Die Hintergrundfarbe wird auch verwendet, wenn Bitmaps von Farbe in Monochrom konvertiert werden und umgekehrt.
Beispiele
Ein Beispiel finden Sie unter "Beispiel für Owner-Drawn Menüelemente" unter Verwenden von Menüs.
Anforderungen
| 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 |