setBrushOrgEx 函数 (wingdi.h)

SetBrushOrgEx 函数设置 GDI 分配给应用程序在指定设备上下文中选择的下一个画笔的画笔原点。

语法

BOOL SetBrushOrgEx(
  [in]  HDC     hdc,
  [in]  int     x,
  [in]  int     y,
  [out] LPPOINT lppt
);

参数

[in] hdc

设备上下文的句柄。

[in] x

新画笔原点的 x 坐标(以设备单位为单位)。 如果此值大于画笔宽度,则使用 modulus 运算符 (nXOrgmod 画笔宽度) 减小该值。

[in] y

新画笔原点的 y 坐标(以设备单位为单位)。 如果此值大于画笔高度,则使用 modulus 运算符 (nYOrgmod 画笔高度) 减小其值。

[out] lppt

指向接收上一个画笔原点的 POINT 结构的指针。

如果不需要以前的画笔原点,此参数可以为 NULL

返回值

如果该函数成功,则返回值为非零值。

如果函数失败,则返回值为零。

注解

画笔是系统用于绘制填充形状内部的位图。

画笔原点是一对坐标,指定位图中一个像素的位置。 默认画笔原点坐标 (0,0) 。 对于水平坐标,值 0 对应于最左侧的像素列;宽度对应于最右侧的列。 对于垂直坐标,值 0 对应于像素的最上面一行;高度对应于最下方的行。

系统自动跟踪所有窗口管理的设备上下文的原点,并根据需要调整其画笔,以保持图面上的图案对齐。 使用此调用设置的画笔原点相对于工作区的左上角。

使用 SetStretchBltMode 将位图拉伸模式设置为 HALFTONE 后,应用程序应调用 SetBrushOrgEx。 必须执行此操作以避免画笔不对齐。

系统自动跟踪所有窗口管理的设备上下文的原点,并根据需要调整其画笔,以保持图面上的图案对齐。

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 wingdi.h (包括 Windows.h)
Library Gdi32.lib
DLL Gdi32.dll

另请参阅

画笔函数

画笔概述

GetBrushOrgEx

SelectObject

SetStretchBltMode

UnrealizeObject