Fonction SetBkColor (wingdi.h)

Article
08/27/2023

La fonction SetBkColor définit la couleur d’arrière-plan actuelle sur la valeur de couleur spécifiée ou sur la couleur physique la plus proche si l’appareil ne peut pas représenter la valeur de couleur spécifiée.

Syntaxe

COLORREF SetBkColor(
  [in] HDC      hdc,
  [in] COLORREF color
);

Paramètres

[in] hdc

Handle dans le contexte de l’appareil.

[in] color

Nouvelle couleur d'arrière-plan. Pour créer une valeur COLORREF , utilisez la macro RVB .

Valeur retournée

Si la fonction réussit, la valeur de retour spécifie la couleur d’arrière-plan précédente sous la forme d’une valeur COLORREF .

Si la fonction échoue, la valeur de retour sera CLR_INVALID.

Remarques

Cette fonction comble les interstices entre les lignes de stylet dessinées à l’aide d’un stylet créé par la fonction CreatePen ; il ne comble pas les espaces entre les lignes de stylet dessinées à l’aide d’un stylet créé par la fonction ExtCreatePen . La fonction SetBkColor définit également les couleurs d’arrière-plan pour TextOut et ExtTextOut.

Si le mode d’arrière-plan est OPAQUE, la couleur d’arrière-plan est utilisée pour combler les espaces entre les lignes de style, les interstices entre les lignes hachurées dans les pinceaux et les cellules de caractères. La couleur d’arrière-plan est également utilisée lors de la conversion de bitmaps de couleur en monochrome et vice versa.

Exemples

Pour obtenir un exemple, consultez « Exemple d’éléments de menu Owner-Drawn » dans Utilisation des menus.

Configuration requise


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wingdi.h (inclure Windows.h)
Bibliothèque	Gdi32.lib
DLL	Gdi32.dll