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_GPIDEFAULTS
 
BOOL GpiSetDefArcParams(hps, parcp)
HPS hps;             /* presentation-space handle                */
PARCPARAMS parcp;    /* pointer to structure with arc parameters */
 
The GpiSetDefArcParams function sets the default arc parameters. The default
arc parameters define the values given to the arc parameters of a
presentation space whenever that presentation space is reset. (The arc
parameters define the shape and orientation of the ellipses drawn using the
arc functions.) A presentation space can be reset using the GpiResetPS
function.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
hps        Identifies the presentation space.
 
parcp      Points to the ARCPARAMS structure that contains the arc
           parameters.
 
Return Value
 
The return value is GPI_OK if the function is successful or 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_PS_BUSY
 
Comments
 
Setting the default arc parameters does not immediately affect the arc
parameters. The system uses the default arc parameters only when the
presentation space is reset. The default arc parameters are reset when the
presentation space is reset using the GRES_SEGMENT or GRES_ALL options of
the GpiResetPS function. The reset values for the default arc parameters are
lP=1, lQ=1, lR=0, and lS=0.
 
See Also
 
GpiFullArc, GpiPartialArc, GpiPointArc, GpiQueryDefArcParams,
WinGetLastError, ARCPARAMS
 
                                      ♦