gpi12.hlp (Table of Contents; Topic list)
GpiSetMarkerBox (1.2)
Function Group  Overview                          Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
#define INCL_GPIPRIMITIVES
 
BOOL GpiSetMarkerBox(hps, psizfxBox)
HPS hps;             /* presentation-space handle                 */
PSIZEF psizfxBox;    /* address of structure with marker box size */
 
The GpiSetMarkerBox function sets the current marker-box attribute. The
marker box specifies the width and height of markers drawn by the GpiMarker
function.
 
If the attribute mode is AM_PRESERVE, the function saves the previous
marker-box attribute on the attribute stack when it sets the new marker box.
The previous marker-box attribute can be retrieved by using the GpiPop
function.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
hps        Identifies the presentation space.
 
psizfxBox  Points to a SIZEF structure containing the size of the marker
           box, in world coordinates.
 
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_INV_HPS
     PMERR_INV_MARKER_BOX_ATTR
     PMERR_PS_BUSY
 
See Also
 
GpiQueryAttrs, GpiQueryMarkerBox, GpiSetAttrs, WinGetLastError, SIZEF