SetBrushOrgEx功能将GDI指定给应用程序选择的【下一个】画笔的画笔原点设置到指定的设备上下文中。
BOOL SetBrushOrgEx(
HDC 【HDC】, | //设备上下文的句柄 |
INT 【nXOrg】, | //新起点的x坐标 |
INT 【nYOrg】, | //新起点的y坐标 |
LPPOINT 【LPPT】 | //指向以前的画笔来源 |
); |
参数
【HDC】
标识设备上下文。
【nXOrg】
指定新笔刷原点的设备单位的x坐标。如果该值大于画笔宽度,则使用模数运算符(【nXOrg】 mod画笔宽度)减小其值。
【nYOrg】
指定新笔刷原点的设备单位的y坐标。如果该值大于画笔高度,则使用模数运算符(【nYOrg】模刷高度)减小其值。
【LPPT】
指向POINT结构,接收以前的画笔来源。
如果不需要先前的画笔原点,则此参数可以为NULL。
返回值
如果函数成功,返回值不为零。
如果函数失败,返回值为零。要获取扩展错误信息,请调用GetLastError.
备注
刷子是操作系统用于绘制填充形状内部的位图。
画笔原点是一对坐标,指定位图中一个像素的位置。默认画笔原点坐标为(0,0)。对于水平坐标,值0对应于最左边的像素列;宽度对应于最右边的列。对于垂直坐标,值0对应于最上面的像素行;高度对应于最下排。
操作系统自动跟踪所有窗口管理的设备上下文的原点,并根据需要调整其刷子以保持表面上的图案对齐。使用此调用设置的画笔原点相对于客户端区域的左上角。
通过SetStretchBltMode将位图拉伸模式设置为HALFTONE后,应用程序应调用SetBrushOrgEx.必须做到这一点,以避免电刷不对准。
Windows NT:操作系统自动跟踪所有窗口管理的设备上下文的原点,并根据需要调整其刷,以保持表面上的图案对齐。
Windows 95:不支持自动跟踪画笔原点。在使用它之前,应用程序必须使用UnrealizeObject,SetBrushOrgEx和SelectObject函数对齐画笔。
也可以看看
GetBrushOrgEx, POINT, SelectObject, SetStretchBltMode, UnrealizeObject