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 (0xFFFFFFFF定義于 Wingdi.h) 中。

圖元必須位於目前裁剪區域的界限內。

並非所有裝置都支援 GetPixel。應用程式應該呼叫 GetDeviceCaps ，以判斷指定的裝置是否支援此函式。

必須在裝置內容中選取點陣圖，否則會在所有圖元上傳回CLR_INVALID。