REQUEST CHOICE
CALL SEQUENCE
void preq_choice (ws_id, choice_dev, status, choice)
INPUT PARAMETERS
Pint ws_id,
Pint choice_dev,
OUTPUT PARAMETERS
Pin_status *status
Pint *choice
ARGUMENTS
- ws_id,
- workstation identifier
- choice_dev,
- Choice device number
- status,
- Input status
- choice
- Choice value
TYPES
typedef enum {
PIN_STATUS_NONE,
PIN_STATUS_OK,
PIN_STATUS_NO_IN
} Pin_status;
PHIGS STATE
(PHOP, WSOP, *, *).
EFFECT
Request an integer by user action on the active input device
choice_dev with the possibility of cancelling the input by activating
the device break.
Example:
/* Request choice on workstation number 1 using device number 40 */
Pint ws_id,choice_dev;
Pin_status status;
Pint choice;
.....
ws_id = 1;
choice_dev = 40;
preq_choice(ws_id,choice_dev,&status,&choice);
......
ERRORS
- 3
Ignoring function, function requires state (PHOP, WSOP,*,*)
- 54
- Ignoring function, the specified workstation is not open
- 61
- Ignoring function, specified workstation is neither of category INPUT nor
of category OUTIN
- 250
- Ignoring function, the specified device is not available on the specified
workstation
- 251
- Ignoring function, the function requires the input device to be in REQUEST
mode
SEE ALSO
set choice mode, initialize choice, sample choice, get choice, await event,
inquire choice device state, inquire default choice device state 3