函数功能:
SetPixelV 函数将指定坐标处的像素设为指定的颜色(与 SetPixel 一样,但效率高一些)。
API 函数原型:
注释:_In_ 说明该参数是输入的,_opt_ 说明该参数是可选参数。
BOOL SetPixelV( _In_ HDC hdc, _In_ int X, _In_ int Y, _In_ COLORREF crColor );
参数解析:
|
参数 |
含义 |
|
hdc |
设备环境句柄 |
|
x |
指定要设置的像素点的 X 轴坐标,按逻辑单位表示坐标 |
|
y |
指定要设置的像素点的 Y 轴坐标,按逻辑单位表示坐标 |
|
crColor |
1. 指定该像素点的颜色 |
注释:COLORREF 颜色被定义为 DWORD 类型(4 个字节),用于表示 RGB 颜色。
返回值:
1. 如果函数调用成功,返回值为非 0;
2. 如果函数调用失败,返回值为 0。
备注:
1. 不是所有设备都支持 SetPixelV 函数。有关详情,请参考 GetDeviceCaps。
2. SetPixelV 函数比 SetPixel 函数快,因为 SetPixelV 不需要返回实际绘制的像素值(返回布尔类型)。




