gpi12.hlp (Table of Contents; Topic list)
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.
GpiSetLineWidthGeom (1.2)
Function Group  Overview                          Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
#define INCL_GPIPRIMITIVES
 
BOOL GpiSetLineWidthGeom(hps, lLineWidth)
HPS hps;            /* presentation-space handle */
LONG lLineWidth;    /* line width                */
 
The GpiSetLineWidthGeom function sets the current geometric-line-width
attribute to the specified value. The geometric line width specifies the
width of lines drawn by using the GpiStrokePath function or the
GpiModifyPath and GpiFillPath pair.
 
If the attribute mode is AM_PRESERVE, the function saves the previous
geometric-line width on the attribute stack when it sets the new width. The
previous geometric-line width can be retrieved using the GpiPop function.
 
Parameter   Description
────────────────────────────────────────────────────────────────────────────
 
hps         Identifies the presentation space.
 
lLineWidth  Specifies the geometric-line width in world coordinates. This
            value cannot be negative. If it is zero, the resulting line has
            zero width.
 
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
the following:
 
     PMERR_INV_GEOM_LINE_WIDTH_ATTR
     PMERR_INV_HPS
     PMERR_PS_BUSY
 
See Also
 
GpiFillPath, GpiModifyPath, GpiPop, GpiQueryAttrs, GpiQueryLineWidthGeom,
GpiSetAttrMode, GpiSetAttrs, GpiStrokePath, WinGetLastError