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 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 wingdi.h (包含 Windows.h)
程式庫 Gdi32.lib
Dll Gdi32.dll

另請參閱

點陣圖函式

位圖概觀

COLORREF

GetDeviceCaps

RGB

SetPixel