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

SET CHOICE MODE (PHOP,WSOP,*,*)

Purpose

Use Set Choice Mode to set the operating mode of the specified choice input device.

After the choice mode is set, the graPHIGS API sets the echoing state to ECHO or NOECHO. Depending on the specified operating mode--Request, Sample, or Event-- an interaction with the given device may begin or end.

Note:

The graPHIGS API resets the input device with the initialization values when your application calls the Description subroutine with the operating mode parameter set to SAMPLE or EVENT.

Language Bindings

C

pset_choice_mode (ws_id, choice_num, op_mode, echo_switch)

Input Parameters

Pint ws_id
Workstation identifier.

Pint choice_num
Choice device number (>=1).

Pop_mode op_mode
Operating mode (0=POP_REQ, 1=POP_SAMPLE, 2=POP_EVENT).

Pecho_switch echo_switch
Echo switch (0=PSWITCH_NO_ECHO, 1=PSWITCH_ECHO).

FORTRAN

PSCHM (wkid, chdnr, mode, esw)

Input Parameters

integer wkid
Workstation identifier.

integer chdnr
Choice device number (>=1).

integer mode
Operating mode (0=PREQU, 1=PSAMPL, 2=PEVENT).

integer esw
Echo switch (0=PNECHO, 1=PECHO).

Errors

3
Function Requires State (PHOP,WSOP,*,*)
54
Specified Workstation Is Not Open
61
Specified Workstation Is Not Of Category Input Or Outin
250
Specified Device Not Available On Workstation

Related Subroutines

  • Await Event

  • Initialize Choice

  • Initialize Choice 3

  • Inquire Number Of Available Logical Input Devices

  • Request Choice

  • Sample Choice

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