setBoundsRect 函数 (wingdi.h)

SetBoundsRect 函数控制指定设备上下文的边框信息的累积。系统可以保留所有绘图操作的边框。应用程序可以检查和设置此矩形。绘图边界可用于使位图缓存失效。

语法

UINT SetBoundsRect(
  [in] HDC        hdc,
  [in] const RECT *lprect,
  [in] UINT       flags
);

[in] hdc

要为其累积边界矩形的设备上下文的句柄。

[in] lprect

指向用于设置边界矩形的 RECT 结构的指针。矩形维度采用逻辑坐标。此参数可以为 NULL。

[in] flags

指定新矩形如何与累积的矩形组合。此参数可以是以下多个值之一。

值	含义
DCB_ACCUMULATE	使用矩形联合操作) 将 lprcBounds 参数指定的矩形添加到边框 (。使用 DCB_RESET 和 DCB_ACCUMULATE将边界矩形设置为 lprcBounds 参数指定的矩形。
DCB_DISABLE	关闭边界累加。
DCB_ENABLE	打开边界累加，默认禁用边界累加。
DCB_RESET	清除边界矩形。

如果函数成功，则返回值指定边界矩形的先前状态。此状态可以是以下值的组合。

值	含义
DCB_DISABLE	边界累积已关闭。
DCB_ENABLE	边界累积已打开。 DCB_ENABLE和DCB_DISABLE是互斥的。
DCB_RESET	边框为空。
DCB_SET	边框不为空。 DCB_SET和DCB_RESET是互斥的。

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

DCB_SET值是位值DCB_ACCUMULATE和DCB_RESET的组合。检查DCB_RESET位以确定边界矩形是否为空的应用程序还必须检查DCB_ACCUMULATE位。仅当DCB_RESET位为 1 且DCB_ACCUMULATE位为 0 时，边界矩形才为空。


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