Funzione GetPixel (wingdi.h)

Articolo
08/27/2023

La funzione GetPixel recupera il valore di colore rosso, verde, blu (RGB) del pixel in corrispondenza delle coordinate specificate.

Sintassi

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

Parametri

[in] hdc

Handle nel contesto del dispositivo.

[in] x

Coordinata x, in unità logiche, del pixel da esaminare.

[in] y

Coordinata y, in unità logiche, del pixel da esaminare.

Valore restituito

Il valore restituito è il valore COLORREF che specifica l'RGB del pixel. Se il pixel è esterno all'area di ritaglio corrente, il valore restituito è CLR_INVALID (0xFFFFFFFF definito in Wingdi.h).

Commenti

Il pixel deve trovarsi entro i limiti dell'area di ritaglio corrente.

Non tutti i dispositivi supportano GetPixel. Un'applicazione deve chiamare GetDeviceCaps per determinare se un dispositivo specificato supporta questa funzione.

Una bitmap deve essere selezionata nel contesto del dispositivo, in caso contrario, CLR_INVALID viene restituita su tutti i pixel.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wingdi.h (include Windows.h)
Libreria	Gdi32.lib
DLL	Gdi32.dll