Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

◄CDC►                                         ◄Up► ◄Contents► ◄Index► ◄Back►
──Microsoft Foundation Classes──────────────────────────────────────────────
 
  Windows 3.1 only
 
  UINT SetBoundsRect( const RECT FAR* lpRectBounds, UINT flags );
 
  Parameter      Description
 
  <lpRectBounds> Points to a RECT structure that is used to set the
                 bounding rectangle. Rectangle dimensions are given in
                 logical coordinates. This parameter can be NULL.
 
  <flags>        Specifies how the new rectangle will be combined with the
                 accumulated rectangle. This parameter may be a
                 combination of the following values:
 
                 Value            Meaning
 
                 DCB_ACCUMULATE   Add the rectangle specified by
                                  <lpRectBounds> to the bounding rectangle
                                  (using a rectangle union operation).
 
                 DCB_DISABLE      Turn off bounds accumulation.
 
                 DCB_ENABLE       Turn on bounds accumulation. (The
                                  default setting for bounds accumulation
                                  is disabled.)
 
  Remarks
 
  Controls the accumulation of bounding-rectangle information for the
  specified device context.
 
  Windows can maintain a bounding rectangle for all drawing operations.
  This rectangle can be queried and reset by the application. The drawing
  bounds are useful for invalidating bitmap caches.
 
  Return Value
 
  The current state of the bounding rectangle, if the function is
  successful. Like <flags>, the return value can be a combination of DCB_
  values, as shown in the following list:
 
  Value            Meaning
 
  DCB_ACCUMULATE   The bounding rectangle is not empty. This value will
                   always be set.
 
  DCB_DISABLE      Bounds accumulation is off.
 
  DCB_ENABLE       Bounds accumulation is on.
 
  See Also
 
  ◄CDC::GetBoundsRect►, ◄::SetBoundsRect►
 
 
                                     -♦-