Freigeben über


GetPixel-Funktion (wingdi.h)

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

Weitere Informationen

Bitmapfunktionen

Übersicht über Bitmaps

COLORREF

GetDeviceCaps

SetPixel