Freigeben über


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

Weitere Informationen

COLORREF

CreatePen

ExtCreatePen

GetBKColor

GetBkMode

Mal- und Zeichenfunktionen

Übersicht über Das Malen und Zeichnen

SetBkMode