GetBoundsRect function (wingdi.h)

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.

Syntax

UINT GetBoundsRect(
  [in]  HDC    hdc,
  [out] LPRECT lprect,
  [in]  UINT   flags
);

Parameters

[in] hdc

A handle to the device context whose bounding rectangle the function will return.

[out] lprect

A 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.

[in] flags

Specifies how the GetBoundsRect function will behave. This parameter can be the following value.

Return value

The return value specifies the state of the accumulated bounding rectangle; it can be one of the following values.

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.

Requirements

See also

Painting and Drawing Functions

Painting and Drawing Overview

SetBoundsRect