[ Previous | Next | Contents | Glossary | Home | Search ]
The graPHIGS Programming Interface: ISO PHIGS Subroutine Reference

GET CHOICE (PHOP,WSOP,*,*)

Purpose

Use Get Choice to retrieve a choice input value from the current event report. The graPHIGS API identified the device to which this value corresponds on the previous invocation of the Await Event subroutine call Await Event The graPHIGS API does not remove the event from the current event report until the next invocation of Await Event.

This subroutine returns a status parameter of OK or NOCHOICE.

Language Bindings

C

pget_choice (in_status, choice)

Output Parameters

Pin_status *in_status
Choice status (1=PIN_STATUS_OK, 2=PIN_STATUS_NO_IN).

Pint *choice
Choice number (>=1).

FORTRAN

PGTCH (stat, chnr)

Output Parameters

integer stat
Choice status (1=POK, 2=PNCHOI).

integer chnr
Choice number (>=1).

Errors

3
Function Requires State (PHOP,WSOP,*,*)
259
Requested Device Class Not Current Input Report Class

Related Subroutines

  • Await Event

    • [ Previous | Next | Contents | Glossary | Home | Search ]