Partager via


SetDCBrushColor, fonction (wingdi.h)

La fonction SetDCBrushColor définit la couleur de pinceau du contexte d’appareil (DC) actuelle sur la valeur de couleur spécifiée. Si l’appareil ne peut pas représenter la valeur de couleur spécifiée, la couleur est définie sur la couleur physique la plus proche.

Syntaxe

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

Paramètres

[in] hdc

Handle pour le contrôleur de domaine.

[in] color

Nouvelle couleur de pinceau.

Valeur retournée

Si la fonction réussit, la valeur de retour spécifie la couleur de pinceau DC précédente en tant que valeur COLORREF .

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

Remarques

Lorsque le DC_BRUSH de stock est sélectionné dans un contrôleur de domaine, tous les dessins suivants sont effectués à l’aide de la couleur de pinceau DC jusqu’à ce que le pinceau de stock soit désélectionné. La couleur de DC_BRUSH par défaut est BLANC.

La fonction retourne la couleur DC_BRUSH précédente, même si le DC_BRUSH de pinceau boursier n’est pas sélectionné dans le contrôleur de domaine . Toutefois, cela ne sera pas utilisé dans les opérations de dessin tant que la DC_BRUSH de stock n’est pas sélectionnée dans le contrôleur de domaine.

La fonction GetStockObject avec un argument DC_BRUSH ou DC_PEN peut être utilisée indifféremment avec les fonctions SetDCPenColor et SetDCBrushColor .

ICM: La gestion des couleurs est effectuée si ICM est activé.

Exemples

Pour obtenir un exemple de définition des couleurs, consultez Définition du stylet ou de la couleur du pinceau.

Configuration requise

Condition requise Valeur
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

COLORREF

Fonctions de contexte de l’appareil

Vue d’ensemble des contextes d’appareil

GetDCBrushColor