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_GPIPRIMITIVES
 
LONG GpiPolyMarker(hps, cptl, aptl)
HPS hps;         /* presentation-space handle                */
LONG cptl;       /* number of points                         */
PPOINTL aptl;    /* address of array of structures for point */
 
The GpiPolyMarker function draws a marker at each point specified by the
aptl parameter. The function places the center of each marker at the given
point. The current marker set and marker-symbol attributes specify the
marker to draw.
 
The function moves the current position to the point of the last marker.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
hps        Identifies a presentation space.
 
cptl       Specifies the number of points.
 
aptl       Points to an array of POINTL structures that contain the points.
 
Return Value
 
The return value is GPI_OK or GPI_HITS if the function is successful (it is
GPI_HITS if the detectable attribute is set for the presentation space and a
correlation hit occurs). The return value is GPI_ERROR if an error occurs.
 
Errors
 
Use the WinGetLastError function to retrieve the error value, which may be
one of the following:
 
     PMERR_INV_COORDINATE
     PMERR_INV_HPS
     PMERR_INV_LENGTH_OR_COUNT
     PMERR_PS_BUSY
 
Example
 
This example uses the GpiPolyMarker function to draw a series of markers. It
then uses the GpiPolyLine function to connect to markers with lines.
 
POINTL ptlStart = { 0, 0 };
POINTL aptl[5] = { 10, 8, 20, 17, 30, 28, 40, 51, 50, 46 };
 
GpiPolyMarker(hps, 5l, aptl);
GpiMove(hps, &ptlStart);
GpiPolyLine(hps, 5L, aptl);
 
See Also
 
GpiMarker, GpiMove, GpiSetAttrs, GpiSetCurrentPosition, GpiSetMarkerBox,
GpiSetMarkerSet, POINTL
 
                                      ♦