Partager via


SetPixelV, fonction (wingdi.h)

La fonction SetPixelV définit le pixel aux coordonnées spécifiées sur l’approximation la plus proche de la couleur spécifiée. Le point doit se trouver dans la zone de découpage et la partie visible de la surface de l’appareil.

Syntaxe

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

Paramètres

[in] hdc

Handle pour 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 différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro.

Remarques

Tous les appareils ne prennent pas en charge la fonction SetPixelV . Pour plus d’informations, consultez la description de la fonctionnalité RC_BITBLT dans la fonction GetDeviceCaps .

SetPixelV est plus rapide que SetPixel , car il n’a pas besoin de retourner la valeur de couleur du point réellement peint.

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

RGB

SetPixel