GPHIGS C FUNCTIONS - FLUSH DEVICE EVENTS

FLUSH DEVICE EVENTS

PFLUSH_EVENTS

CALL SEQUENCE

void pflush_events(

Pint 	ws_id,	/* workstation identifier	*/
Pin_class	class,	/* device class	*/
Pint 	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