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

FLUSH DEVICE EVENTS (PHOP,WSOP,*,*)

Purpose

Use Flush Device Events to discard all input events from the specified logical input device.

This subroutines removes all events received from the specified input device, matching the specified device class, workstation identifier and device number, from the event queue. Input classes include: LOCATOR, STROKE, VALUATOR, CHOICE, PICK, and STRING.

If the current event report includes an event matching the specified input device, then the graPHIGS API also removes the current event report.

Language Bindings

C

pflush_events (ws_id, dev_class, in_num)

Input Parameters

Pint ws_id
Workstation identifier.

Pin_class dev_class
Input device class (0=PIN_NONE, 1=PIN_LOC, 2=PIN_STROKE, 3=PIN_VAL, 4=PIN_CHOICE, 5=PIN_PICK, 6=PIN_STRING).

Pint in_num
Logical input device number (>=1).

FORTRAN

PFLUSH (wkid, icl, idnr)

Input Parameters

integer wkid
Workstation identifier.

integer icl
Input device class (1=PLOCAT, 2=PSTROK, 3=PVALUA, 4=PCHOIC, 5=PPICK, 6=PSTRIN).

integer idnr
Logical input device number (>=1).

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
256
Warning, Input Queue Has Overflowed

Note:

The graPHIGS API performs this operation even if error 256 occurs.

Related Subroutines

  • Inquire Number Of Available Logical Input Devices

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