Microsoft Foundation Classes (mfc.hlp) (Table of Contents; Topic list)
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.
class CRgn
CGdiObject                                  Up Contents Index Back
──Microsoft Foundation Classes──────────────────────────────────────────────
 
  Description
 
  The CRgn class encapsulates a Windows graphical design interface (GDI)
  region. A region is an elliptical or polygonal area within a window. To
  use regions, you use the member functions of class CRgn in conjunction
  with the clipping functions defined as members of class CDC.
 
  The member functions of CRgn create, alter, and retrieve information
  about the region object for which they are called.
 
  Public Members
 
  Construction/Destruction
 
  CRgn   Constructs a CRgn object.
 
  Initialization
 
  CreateRectRgn               Initializes a CRgn object with a
                                rectangular region.
 
  CreateRectRgnIndirect       Initializes a CRgn object with a
                                rectangular region defined by a RECT
                                structure.
 
  CreateEllipticRgn           Initializes a CRgn object with an
                                elliptical region.
 
  CreateEllipticRgnIndirect   Initializes a CRgn object with an
                                elliptical region defined by a RECT
                                structure.
 
  CreatePolygonRgn            Initializes a CRgn object with a polygonal
                                region. The system closes the polygon
                                automatically, if necessary, by drawing a
                                line from the last vertex to the first.
 
  CreatePolyPolygonRgn        Initializes a CRgn object with a region
                                consisting of a series of closed polygons.
                                The polygons may be disjoint or they may
                                overlap.
 
  CreateRoundRectRgn          Initializes a CRgn object with a
                                rectangular region with rounded corners.
 
  CombineRgn                  Initialize a CRgn object so that it is
                                equivalent to the union of two specified
                                CRgn objects.
 
  CopyRgn                     Initializes a CRgn object so that it is a
                                copy of a specified CRgn object.
 
  Operations
 
  EqualRgn       Checks two CRgn objects to determine whether they are
                   equivalent.
 
  FromHandle     Returns a pointer to a CRgn object when given a handle
                   to a Windows region.
 
  GetRgnBox      Retrieves the coordinates of the bounding rectangle of
                   a CRgn object.
 
  OffsetRgn      Moves a CRgn object by the specified offsets.
 
  PtInRegion     Determines whether a specified point is in the region.
 
  RectInRegion   Determines whether any part of a specified rectangle is
                   within the boundaries of the region.
 
  SetRectRgn     Sets the CRgn object to the specified rectangular
                   region.
 
 
                                     -♦-