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。

這可以是下列值。

傳回碼 Description
ERROR_INVALID_PARAMETER
一或多個輸入參數無效。

備註

如果圖元座標位於目前裁剪區域之外,函式就會失敗。

並非所有裝置都支援 SetPixel 函式。 如需詳細資訊,請參閱 GetDeviceCaps

規格需求

需求
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 wingdi.h (包含 Windows.h)
程式庫 Gdi32.lib
Dll Gdi32.dll

另請參閱

點陣圖函式

位圖概觀

COLORREF

GetDeviceCaps

GetPixel

RGB

SetPixelV