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 |
---|---|
|
一或多個輸入參數無效。 |
如果圖元座標位於目前裁剪區域之外,函式就會失敗。
並非所有裝置都支援 SetPixel 函式。 如需詳細資訊,請參閱 GetDeviceCaps。
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | wingdi.h (包含 Windows.h) |
程式庫 | Gdi32.lib |
Dll | Gdi32.dll |