SetPixel

SetPixel

函數將指定坐標處的像素設為指定的顏色。

功能


函數原型:COLORREF SetPixel(HDC hdc, int X, int Y, COLORREF crColor);

參數


設備環境句柄。
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 )