GetPixel 関数 (wingdi.h)

GetPixel 関数は、指定した座標にあるピクセルの赤、緑、青 (RGB) の色値を取得します。

構文

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

[in] hdc

[in] x

検査するピクセルの x 座標を論理単位で指定します。

[in] y

調べるピクセルの y 座標を論理単位で指定します。

戻り値は、ピクセルの RGB を指定する COLORREF 値です。ピクセルが現在のクリッピング領域の外側にある場合、戻り値はCLR_INVALIDされます (Wingdi.h で定義0xFFFFFFFF)。

ピクセルは、現在のクリッピング領域の境界内にある必要があります。

すべてのデバイスで GetPixel がサポートされているわけではありません。アプリケーションは GetDeviceCaps を呼び出して、指定されたデバイスがこの関数をサポートしているかどうかを判断する必要があります。

ビットマップはデバイスコンテキスト内で選択する必要があります。それ以外の場合は、すべてのピクセルでCLR_INVALIDが返されます。


サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	wingdi.h (Windows.h を含む)
Library	Gdi32.lib
[DLL]	Gdi32.dll