GetBoundsRect

3.1

  UINT GetBoundsRect(hdc, lprcBounds, flags)    
  HDC hdc; /* handle of device context */
  RECT FAR* lprcBounds; /* address of structure for bounding rectangle */
  UINT flags; /* specifies information to return */

The GetBoundsRect function returns the current accumulated bounding rectangle for the specified device context.

Parameters

hdc

Identifies the device context to return the bounding rectangle for.

lprcBounds

Points to a buffer that will receive the current bounding rectangle. The rectangle is returned in logical coordinates.

flags

Specifies whether the bounding rectangle is to be cleared after it is returned. This parameter can be DCB_RESET, to clear the rectangle. Otherwise, it should be zero.

Return Value

The return value is DCB_SET if the bounding rectangle is not empty. Otherwise, it is DCB_RESET.

Comments

To ensure that the bounding rectangle is empty, check both the DCB_RESET bit and the DCB_ACCUMULATE bit in the return value. If DCB_RESET is set and DCB_ACCUMULATE is not, the bounding rectangle is empty.

See Also

SetBoundsRect