描述
SetBrushOrgEx函数设置GDI指定给应用程序在指定设备上下文中选择的下一个画笔的画笔原点。
C++ 语法
BOOL SetBrushOrgEx( __in HDC hdc, __in int nXOrg, __in int nYOrg, __out LPPOINT lppt ); |
PowerBASIC 语法
FUNCTION SetBrushOrgEx( _ BYVAL hdc AS DWORD, _ BYVAL nXOrg AS LONG, _ BYVAL nYOrg AS LONG, _ BYREF lppt AS POINT _ ) AS LONG |
参数
hdc
[in]处理设备上下文。
nXOrg
[in]指定新笔刷原点的x坐标（以设备为单位）。如果该值大于画笔宽度，则使用模数运算符（nXOrgMOD画笔宽度）减小其值。
nYOrg
[in]指定新笔刷原点的y坐标（以设备为单位）。如果该值大于画笔高度，则使用模数运算符（nYOrgMOD画笔高度）减小其值。
lppt
[out]指向POINT结构的指针，可以接收以前的画笔来源。
如果不需要先前的画笔原点，则此参数可以为NULL。
返回值
如果函数成功，返回值不为零。
如果函数失败，返回值为零。
Windows NT / 2000 / XP / Vista / Windows 7：要获取扩展错误信息，请调用GetLastError.
备注
刷子是系统用于绘制填充形状内部的位图。
画笔原点是一对坐标，指定位图中一个像素的位置。默认画笔原点坐标为（0,0）。对于水平坐标，值0对应于最左边的像素列;宽度对应于最右边的列。对于垂直坐标，值0对应于最上面的像素行;高度对应于最下排。
系统自动跟踪所有窗口管理的设备上下文的原点，并根据需要调整刷子，以保持表面上的图案对齐。使用此调用设置的画笔原点相对于客户端区域的左上角。
使用SetStretchBltMode将位图拉伸模式设置为HALFTONE后，应用程序应调用SetBrushOrgEx.必须做到这一点，以避免电刷不对准。
Windows NT / 2000 / XP / Vista / Windows 7：系统自动跟踪所有窗口管理的设备上下文的原点，并根据需要调整其刷，以保持表面上的图案对齐。
Windows 95/98 / Me：不支持自动跟踪画笔原点。在使用它之前，应用程序必须使用UnrealizeObject，SetBrushOrgEx和SelectObject函数对齐画笔。
引用文件 #INCLUDE Once
WinGdi.inc（包括Windows.inc）