setPixel 函数 (wingdi.h)

SetPixel 函数将指定坐标处的像素设置为指定颜色。

语法

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

[in] hdc

设备上下文的句柄。

[in] x

要设置的点的 x 坐标（以逻辑单位为单位）。

[in] y

要设置的点的 y 坐标（以逻辑单位为单位）。

[in] color

用于绘制点的颜色。若要创建 COLORREF 颜色值，请使用 RGB 宏。

如果函数成功，则返回值是函数将像素设置为的 RGB 值。此值可能与 crColor 指定的颜色不同;在找不到指定颜色的完全匹配项时发生的。

如果函数失败，返回值为 -1。

此值可以是以下值。

返回代码	说明
ERROR_INVALID_PARAMETER	一个或多个输入参数无效。

如果像素坐标位于当前剪切区域之外，则函数失败。

并非所有设备都支持 SetPixel 函数。有关详细信息，请参阅 GetDeviceCaps。

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