Name

PQCHS − Returns information about the choice device state. 

Operating States: PHOP, WSOP, ∗, ∗
PHIGS standard function
 

Syntax

PQCHS (WKID, CHDNR, MLDR, ERRIND, MODE, ESW, ISTAT, ICHNR, PET, EAREA,
LDR, DATREC)

Argument          Data Type      Access    Description
---------------------------------------------------------------------------
WKID              Integer        Read      Workstation identifier
CHDNR             Integer        Read      Choice device number
MLDR              Integer        Read      Size of the data record array,
                                           in bytes
ERRIND            Integer        Write     Error indicator
MODE              Integer        Write     Operating mode
ESW               Integer        Write     Echo switch
ISTAT             Integer        Write     Initial status
ICHNR             Integer        Write     Initial choice number
PET               Integer        Write     Prompt and echo type
EAREA(4)          Array of       Write     Echo area, in device coordinates
                  reals                    (XMIN, XMAX, YMIN, YMAX)
LDR               Integer        Write     Number of array elements used in
                                           a data record
DATREC(MLDR)      Character ∗80  Write     Data record
---------------------------------------------------------------------------

Constants

Defined Argument     Constant     Description
---------------------------------------------------------------------------
MODE                 PREQU        Request mode.
                     PSAMPL       Sample mode.
                     PEVENT       Event mode.
ESW                  PNECHO       Echo disabled.
                     PECHO        Echo enabled.
ISTAT                POK          An initial choice exists.
                     PNCHOI       An initial choice does not exist.
---------------------------------------------------------------------------

Description

PQCHS queries the workstation state list.  The function returns an error indicator and values for the following:

•Operating mode

•Echo switch

•Initial choice status

•Prompt and echo type

•Echo area in device coordinates

•Choice data record

See Chapter 9 for information on building data records for initializing input devices. 

See Also

PINCH
PQCHS3
PSCHM