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.

◄Function Group►  ◄Overview►                          ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
#define INCL_GPIREGIONS
 
LONG GpiEqualRegion(hps, hrgn1, hrgn2)
HPS hps;       /* presentation-space handle   */
HRGN hrgn1;    /* handle of the first region  */
HRGN hrgn2;    /* handle of the second region */
 
The GpiEqualRegion function checks two regions for equality. Regions are
equal if the difference between the two regions is an empty region. The
function compares the regions only if the device context containing the
regions is associated with the given presentation space.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
hps        Identifies the presentation space.
 
hrgn1      Identifies the first region.
 
hrgn2      Identifies the second region.
 
Return Value
 
The return value is EQRGN_NOTEQUAL or EQRGN_EQUAL if the function is
successful, or EQRGN_ERROR if an error occurred.
 
Errors
 
Use the WinGetLastError function to retrieve the error value, which may be
one of the following:
 
     PMERR_INV_HPS
     PMERR_INV_HRGN
     PMERR_PS_BUSY
 
See Also
 
WinEqualRect
 
                                      ♦