該函式將指定坐標處的像素設為指定的顏色。
基本介紹
- 外文名：SetPixel
- 功能：將指定像素設為指定的顏色
- 原型：COLORREF SetPixel
- 類別：計算機函式
功能,參數,返回值,備註,要求,請參閱,
功能
函式功能：該函式將指定坐標處的像素設為指定的顏色。
函式原型：COLORREF SetPixel(HDC hdc, int X, int Y, COLORREF crColor)；
參數
hdc
設備環境句柄。
X
指定要設定的點的X軸坐標，按邏輯單位表示坐標。
Y
指定要設定的點的Y軸坐標，按邏輯單位表示坐標。
crColor
指定要用來繪製該點的顏色。
返回值
如果函式執行成功，那么返回值就是函式設定像素的RGB顏色值。這個值可能與crColor指定的顏色有所不同，之所以有時發生這種情況是因為沒有找到對指定顏色進行真正匹配造成的。
如果函式失敗，那么返回值是-1。
Windows NT：若想獲得更多的錯誤信息，請調用GetLastError函式。
備註
如果像素點坐標位於當前剪輯區之外，那么該函式執行失敗。
不是所有設備都支持SetPixel函式。有關詳情，請參考GetDeviceCaps。
要求
Windows NT：3.1及以上版本；
Windows：95及以上版本；
Windows CE：1.0及以上版本；
頭檔案：wingdi.h；
庫檔案：gdi32.lib。
請參閱
Graphics.setPixel
Sets a pixel to the specified color.
Syntax
public final void setPixel( Point pt )
public final void setPixel( Point pt, Color color )
public final void setPixel( Point pt, Color color, RasterOp op )
public final void setPixel( int x, int y )
public final void setPixel( int x, int y, Color color )
public final void setPixel( int x, int y, Color color, RasterOp op )
