描述
SetPixel函数将指定坐标处的像素设置为指定的颜色。
C++ 语法
COLORREF SetPixel( __in HDC hdc, __in int X, __in int Y, __in COLORREF crColor ); |
PowerBASIC 语法
FUNCTION SetPixel( _ BYVAL hdc AS DWORD, _ BYVAL X AS LONG, _ BYVAL Y AS LONG, _ BYVAL crColor AS DWORD _ ) AS DWORD |
参数
HDC
[in]处理设备上下文。
X
[in]指定要设置点的x坐标（以逻辑为单位）。
Y
[in]指定要设置的点的y坐标（以逻辑为单位）。
crColor
[in]指定用于绘制点的颜色。要创建COLORREF颜色值，请使用PowerBASIC RGB功能。
返回值
如果函数成功，则返回值是函数将像素设置为的RGB值。该值可能与crColor指定的颜色不同;当无法找到指定颜色的精确匹配时发生。
如果函数失败，返回值为1。
Windows NT / 2000 / XP / Vista / Windows 7：要获取扩展错误信息，请调用GetLastError.这可以是以下值。
值 |
含义 |
ERROR_INVALID_PARAMETER |
一个或多个输入参数无效。 |
备注
如果像素坐标位于当前剪辑区域之外，该函数将失败。
并非所有设备都支持SetPixel功能。有关详细信息，请参阅GetDeviceCaps.
引用文件 #INCLUDE Once
WinGdi.inc（包括Windows.inc）