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。

此值可以是以下值。

注解

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

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

要求

另请参阅

位图函数

位图概述

COLORREF

GetDeviceCaps

GetPixel

RGB

SetPixelV