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。

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 wingdi.h (包括 Windows.h)
Library Gdi32.lib
DLL Gdi32.dll

另请参阅

位图函数

位图概述

COLORREF

GetDeviceCaps

SetPixel