GetPixel-Funktion (wingdi.h)

Artikel
08/27/2023

Die GetPixel-Funktion ruft den rot-grünen, blauen (RGB)-Farbwert des Pixels bei den angegebenen Koordinaten ab.

Syntax

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

Parameter

[in] hdc

Ein Handle für den Gerätekontext.

[in] x

Die x-Koordinate in logischen Einheiten des zu untersuchenden Pixels.

[in] y

Die y-Koordinate in logischen Einheiten des zu untersuchenden Pixels.

Rückgabewert

Der Rückgabewert ist der COLORREF-Wert , der das RGB des Pixels angibt. Wenn sich das Pixel außerhalb des aktuellen Beschneidungsbereichs befindet, wird der Rückgabewert CLR_INVALID (0xFFFFFFFF in Wingdi.h definiert).

Hinweise

Das Pixel muss innerhalb der Grenzen des aktuellen Beschneidungsbereichs liegen.

Nicht alle Geräte unterstützen GetPixel. Eine Anwendung sollte GetDeviceCaps aufrufen, um zu bestimmen, ob ein angegebenes Gerät diese Funktion unterstützt.

Eine Bitmap muss im Gerätekontext ausgewählt werden, andernfalls wird CLR_INVALID auf allen Pixeln zurückgegeben.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wingdi.h (windows.h einschließen)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll