GetBoundsRect

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
);
 

Parameters

hdc
Handle to the device context whose bounding rectangle the function will return.
lprcBounds
Pointer to the RECT structure that will receive the current bounding rectangle. The application's rectangle is returned in logical coordinates, and the bounding rectangle is returned in screen coordinates.
flags
Specifies aspects of how the GetBoundsRect function will operate on a given call. This parameter can be the following value.
Value Meaning
DCB_RESET Clears the bounding rectangle after returning it. If this flag is not set, the bounding rectangle will not be cleared.

Return Values

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.

Remarks

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.

QuickInfo

  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.

See Also

Painting and Drawing Overview, Painting and Drawing Functions, SetBoundsRect