Partager via


Fonction SetDCPenColor (wingdi.h)

La fonction SetDCPenColor définit la couleur de stylet 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 SetDCPenColor(
  [in] HDC      hdc,
  [in] COLORREF color
);

Paramètres

[in] hdc

Handle du contrôleur de domaine.

[in] color

Nouvelle couleur de stylet.

Valeur retournée

Si la fonction réussit, la valeur de retour spécifie la couleur de stylet DC précédente sous la forme d’une valeur COLORREF . Si la fonction échoue, la valeur de retour sera CLR_INVALID.

Remarques

La fonction retourne la couleur DC_PEN précédente, même si le stylet stock DC_PEN 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 le stock DC_PEN n’est pas sélectionné 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 de la couleur du stylet ou 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 d’appareil

Vue d’ensemble des contextes d’appareil

GetDCPenColor