◄Function Group►  ◄Overview►                          ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
#define INCL_GPIBITMAPS
 
LONG GpiQueryPel(hps, pptl)
HPS hps;         /* presentation-space handle                */
PPOINTL pptl;    /* address of structure with point to query */
 
The GpiQueryPel function returns the color of a pel at the specified point.
The point, given in world coordinates, must be in any of the current
clipping objects: clip path, viewing limits, graphics field, clip region, or
visible region.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
hps        Identifies the presentation space.
 
pptl       Points to the POINTL structure that contains the world
           coordinates of the point.
 
Return Value
 
The return value is the color index of the pel if the function is successful
or GPI_ALTERROR if an error occurred.
 
Errors
 
Use the WinGetLastError function to retrieve the error value, which may be
one of the following:
 
     PMERR_INV_COORDINATE
     PMERR_INV_HPS
     PMERR_PS_BUSY
     PMERR_PEL_IS_CLIPPED
 
See Also
 
GpiPtVisible, GpiSetPel, POINTL
 
                                      ♦