Fonction SetBkColor (wingdi.h)
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 |
Voir aussi
Fonctions de peinture et de dessin
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour