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_GPISEGMENTS
 
BOOL GpiDrawChain(hps)
HPS hps;    /* presentation-space handle */
 
The GpiDrawChain function draws the picture chain. The function draws all
segments in the picture chain, including called segments. GpiDrawChain draws
the segments using the current draw controls (except correlation control),
as set by the GpiSetDrawControl function. The function does not affect
drawing modes or open segments.
 
The function cannot be used in an area, path, or element bracket.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
hps        Identifies the presentation space.
 
Return Value
 
The return value is GPI_OK if the function is successful or GPI_ERROR if an
error occurred.
 
Errors
 
Use the WinGetLastError function to retrieve the error value, which may be
one of the following:
 
     PMERR_AREA_INCOMPLETE
     PMERR_IMAGE_INCOMPLETE
     PMERR_INV_HPS
     PMERR_INV_MICROPS_FUNCTION
     PMERR_PATH_INCOMPLETE
     PMERR_PS_BUSY
     PMERR_STOP_DRAW_OCCURRED
 
See Also
 
GpiCloseSegment, GpiDrawDynamics, GpiDrawFrom, GpiDrawSegment,
GpiQuerySegmentNames, GpiSetDrawControl, WinGetLastError
 
                                      ♦