SetBkColor-Funktion (wingdi.h)

Artikel
08/27/2023

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