Partager via


GetPixel, fonction (wingdi.h)

La fonction GetPixel récupère la valeur de couleur rouge, vert, bleu (RVB) du pixel aux coordonnées spécifiées.

Syntaxe

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

Paramètres

[in] hdc

Handle pour le contexte de l’appareil.

[in] x

Coordonnée x, en unités logiques, du pixel à examiner.

[in] y

Coordonnée y, en unités logiques, du pixel à examiner.

Valeur retournée

La valeur de retour est la valeur COLORREF qui spécifie le RVB du pixel. Si le pixel est en dehors de la zone de découpage actuelle, la valeur de retour est CLR_INVALID (0xFFFFFFFF définie dans Wingdi.h).

Remarques

Le pixel doit se trouver dans les limites de la zone de découpage actuelle.

Tous les appareils ne prennent pas en charge GetPixel. Une application doit appeler GetDeviceCaps pour déterminer si un appareil spécifié prend en charge cette fonction.

Une bitmap doit être sélectionnée dans le contexte de l’appareil, sinon, CLR_INVALID est retournée sur tous les pixels.

Configuration requise

   
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

SetPixel