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 更快，因為它不需要傳回實際繪製點的色彩值。