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。