Partager via


Fonction SetPixel (wingdi.h)

La fonction SetPixel définit le pixel aux coordonnées spécifiées sur la couleur spécifiée.

Syntaxe

COLORREF SetPixel(
  [in] HDC      hdc,
  [in] int      x,
  [in] int      y,
  [in] COLORREF color
);

Paramètres

[in] hdc

Handle dans le contexte de l’appareil.

[in] x

Coordonnée x, en unités logiques, du point à définir.

[in] y

Coordonnée y, en unités logiques, du point à définir.

[in] color

Couleur à utiliser pour peindre le point. Pour créer une valeur de couleur COLORREF , utilisez la macro RVB .

Valeur retournée

Si la fonction réussit, la valeur de retour est la valeur RVB sur laquelle la fonction définit le pixel. Cette valeur peut différer de la couleur spécifiée par crColor ; qui se produit lorsqu’une correspondance exacte pour la couleur spécifiée est introuvable.

Si la fonction échoue, la valeur de retour est -1.

Il peut s’agir de la valeur suivante.

Code de retour Description
ERROR_INVALID_PARAMETER
Un ou plusieurs des paramètres d’entrée n’est pas valide.

Remarques

La fonction échoue si les coordonnées de pixel se trouvent en dehors de la région de découpage actuelle.

Tous les appareils ne prennent pas en charge la fonction SetPixel . Pour plus d’informations, consultez GetDeviceCaps.

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

Fonctions bitmap

Vue d’ensemble des bitmaps

COLORREF

GetDeviceCaps

GetPixel

RGB

SetPixelV