GetPixel, fonction (wingdi.h)

Article
08/27/2023

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