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 |