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

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

Purpose

Use Set String Mode to set the operating mode of the specified string device.

After the string 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_string_mode (ws_id, string_num, op_mode, echo_switch)

Input Parameters

Pint ws_id
Workstation identifier.

Pint string_num
String 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

PSSTM (wkid, stdnr, mode, esw)

Input Parameters

integer wkid
Workstation identifier.

integer stdnr
String 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 String

  • Initialize String 3

  • Inquire Number Of Available Logical Input Devices

  • Request String

  • Sample String

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