SetBoundsRect

描述

SetBoundsRect功能控制指定设备上下文的边界矩形信息的累积。系统可以为所有绘图操作维护一个边界矩形。应用程序可以检查并设置此矩形。绘图边界对于无效位图缓存非常有用。

C++ 语法

UINT SetBoundsRect(

__in HDC hdc,

__in const RECT *lprcBounds,

__in UINT flags

);

PowerBASIC 语法

FUNCTION SetBoundsRect ( _

BYVAL hdc AS DWORD, _

BYREF lprcBounds AS RECT, _

BYVAL flags AS DWORD _

) AS DWORD

参数

hdc

[in]处理要累积边界矩形的设备上下文。

lprcBounds

[in]指向用于设置边界矩形的RECT结构的指针。矩形尺寸为逻辑坐标。此参数可以为NULL。

flag

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

值	含义
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时，边界矩形为空。

引用文件 #INCLUDE Once

WinGdi.inc（包括Windows.inc）