SetPixel

小甲鱼

函数功能：

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


API 函数原型：

注释：_In_ 说明该参数是输入的，_opt_ 说明该参数是可选参数。

COLORREF SetPixel(
  _In_  HDC hdc,
  _In_  int x,
  _In_  int y,
  _In_  COLORREF crColor
);

参数解析：

参数	含义
hdc	设备环境句柄
x	指定要设置的像素点的 X 轴坐标，按逻辑单位表示坐标
y	指定要设置的像素点的 Y 轴坐标，按逻辑单位表示坐标
crColor	1. 指定该像素点的颜色 2. 使用 RGB 宏创建 COLORREF 的颜色值

注释：COLORREF 颜色被定义为 DWORD 类型（4 个字节），用于表示 RGB 颜色。


返回值：

1. 如果函数调用成功，那么返回值就是函数设置像素的 RGB 颜色值（这个值可能与 crColor 指定的颜色有所不同，之所以有时发生这种情况是因为没有找到对指定颜色进行真正匹配造成的）；

2. 如果函数调用失败，那么返回值是 -1。

可以是以下值

返回值	含义
ERROR_INVALID_PARAMETER	一个或者多个参数不正确

备注：

1. 如果像素点坐标位于当前剪裁区之外，那么该函数执行失败。

2. 不是所有设备都支持 SetPixel 函数。有关详情，请参考 GetDeviceCaps。

【API档案】版权归鱼C工作室（www.fishc.com）所有，转载请注明来源。

fanzhihao

非常

谦虚求学