Fonction SetPixel (wingdi.h)
La fonction SetPixel définit le pixel aux coordonnées spécifiées sur la couleur spécifiée.
COLORREF SetPixel(
[in] HDC hdc,
[in] int x,
[in] int y,
[in] COLORREF color
);
[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 .
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 |
---|---|
|
Un ou plusieurs des paramètres d’entrée n’est pas valide. |
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.
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 |