Name

pget_choice − Returns information about a user choice. 

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

Syntax

void pget_choice (
  Pin_status  ∗in_status,  /∗ (O) Choice status ∗/
  Pint        ∗choice      /∗ (O) Choice information ∗/
)

Data Structures

typedef enum {
    PIN_STATUS_NONE,    /∗ not used with this function ∗/
    PIN_STATUS_OK,      /∗ user made a valid choice ∗/
    PIN_STATUS_NO_IN    /∗ user did not make a valid choice ∗/
} Pin_status;

Description

pget_choice obtains information contained in the current event report entry.  If the report contains input generated by anything other than a choice-class input device, a call to this function generates an error.  (See the pawait_event function for more information about input classes and the current event report.) 

See Also

pawait_event
pflush_events
pinit_choice
pinit_choice3
preq_choice
psample_choice
pset_choice_mode