setPixelV 函数 (wingdi.h)

SetPixelV 函数将指定坐标处的像素设置为最接近指定颜色的近似值。该点必须位于剪切区域和设备图面的可见部分。

语法

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

[in] hdc

设备上下文的句柄。

[in] x

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

[in] y

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

[in] color

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

如果该函数成功，则返回值为非零值。

如果函数失败，则返回值为零。

并非所有设备都支持 SetPixelV 函数。有关详细信息，请参阅 GetDeviceCaps 函数中RC_BITBLT功能的说明。

SetPixelV 比 SetPixel 更快，因为它不需要返回实际绘制的点的颜色值。

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