gpi12.hlp (Table of Contents; Topic list)
GpiQueryInitialSegmentAttrs (1.2)
Function Group  Overview                          Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
#define INCL_GPISEGMENTS
 
LONG GpiQueryInitialSegmentAttrs(hps, lAttribute)
HPS hps;            /* presentation-space handle */
LONG lAttribute;    /* attribute                 */
 
The GpiQueryDrawControl function checks whether the initial segment
attribute specified by lAttribute is enabled. The function returns ATTR_ON
or ATTR_OFF to specify whether the given attribute is enabled or disabled.
 
Parameter   Description
────────────────────────────────────────────────────────────────────────────
 
hps         Identifies the presentation space.
 
lAttribute  Specifies the attributes to check. It can be one of the
            following values:
 
            Value                 Meaning
            ────────────────────────────────────────────────────────────────
            ATTR_CHAINED          Chained
 
            ATTR_DETECTABLE       Detectability
 
            ATTR_DYNAMIC          Dynamic
 
            ATTR_FASTCHAIN        Fast chaining
 
            ATTR_PROP_DETECTABLE  Propagate detectability
 
            ATTR_PROP_VISIBLE     Propagate visibility
 
            ATTR_VISIBLE          Visibility
 
Return Value
 
The return value is ATTR_ON or ATTR_OFF if the function is successful, or
ATTR_ERROR if an error occurred.
 
Errors
 
Use the WinGetLastError function to retrieve the error value, which may be
the following:
 
     PMERR_INV_HPS
     PMERR_INV_LENGTH_OR_COUNT
     PMERR_INV_MICROPS_FUNCTION
     PMERR_INV_SEG_ATTR
     PMERR_PS_BUSY
 
See Also
 
GpiSetInitialSegmentAttrs, WinGetLastError