The GetBoundsRect function obtains the current accumulated bounding rectangle for a specified device context.
The system maintains an accumulated bounding rectangle for each application. An application can retrieve and set this rectangle.
UINT GetBoundsRect(
HDC hdc, // handle to device context of interest
LPRECT lprcBounds, // pointer to structure to receive bounding rectangle
UINT flags // specifies function options
);
Value | Meaning |
---|---|
DCB_RESET | Clears the bounding rectangle after returning it. If this flag is not set, the bounding rectangle will not be cleared. |
The return value specifies the state of the accumulated bounding rectangle; it can be one of the following values.
Value | Meaning |
---|---|
0 | An error occurred. The given device context handle is invalid. |
DCB_DISABLE | Boundary accumulation is off. |
DCB_ENABLE | Boundary accumulation is on. |
DCB_RESET | The bounding rectangle is empty. |
DCB_SET | The bounding rectangle is not empty. |
The DCB_SET value is a combination of the bit values DCB_ACCUMULATE and DCB_RESET. Applications that check the DCB_RESET bit to determine whether the bounding rectangle is empty must also check the DCB_ACCUMULATE bit. The bounding rectangle is empty only if the DCB_RESET bit is 1 and the DCB_ACCUMULATE bit is 0.
Windows NT: Requires version 3.1 or later.
Windows: Requires Windows 95 or later.
Windows CE: Unsupported.
Header: Declared in wingdi.h.
Import Library: Use gdi32.lib.
Painting and Drawing Overview, Painting and Drawing Functions, SetBoundsRect