PHIGURE C REFERENCE MANUAL - FLUSH DEVICE EVENTS

FLUSH DEVICE EVENTS

pflush_events

CALL SEQUENCE

void pflush_events (ws_id, class, input_dev)

INPUT PARAMETERS

Pint	ws_id,
Pin_class	class,
Pint	input_dev

ARGUMENTS

ws_id,: Workstation identifier
class,: Device class
input_dev: Logical input device number

TYPES

typedef enum {
	PIN_NONE, 
	PIN_LOC, 
	PIN_STROKE, 
	PIN_VAL, 
	PIN_CHOICE, 
	PIN_PICK, 
	PIN_STRING
} Pin_class;

PHIGS STATE

(PHOP, WSOP, *, *).

EFFECT

Destroys all class class events in the input queue which come from the input logical device input_dev on workstation ws_id.

Note:

Operation takes place even if the event queue is full (error 256).

Example:

/* Flush LOCATOR event into the PHIGS event queue for device number 2 on workstation 1 */
	Pint ws_id,input_dev;
	Pin_class class;
	......
	ws_id = 1;
	input_dev = 2;
	class = PIN_LOC;
	pflush_events(ws_id,class,input_dev);
	......

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
256: Warning, the input queue has overflowed