DISABLE_EVENTS(3G)

NAME

disable_events − disable the queuing of events from the specified graphic input device.

SYNOPSIS

C SYNTAX

int disable_events(fildes,class,ordinal);
int fildes,class,ordinal;

FORTRAN77 SYNTAX

integer*4 function disable_events(fildes,class,ordinal)
integer*4 fildes,class,ordinal

PASCAL SYNTAX

function disable_events(fildes,class,
ordinal:integer):integer;

HP-UX COMPATIBILITY

Level: HP-UX/STANDARD

Origin: HP

DESCRIPTION

INPUT PARAMETERS

fildes
is an integer file descriptor returned by gopen when an I/O path to a graphics device is opened.
class
is one of the following device classes : LOCATOR, CHOICE or ALL. The integer values assigned for these class designators are found in the starbase include file used with your program.
ordinal
is a logical device number ranging from 1 to the number of devices in the specified class. LOCATOR and CHOICE devices have device dependent ordinal values. See inquire_input_capabilities for details. If class equals ALL, then ordinal is ignored.

DISCUSSION

Disable_events disables the queuing of events in the Starbase event queue from the device specified by fildes , class , and ordinal . A single event queue is used by all system graphic input devices. The function returns 0 when successful.

If class is set to ALL, then ordinal is ignored and events are disabled for all logical devices specified by fildes.

If the device is not initialized or does not exist, a non-zero function value is returned. If the device was not enabled for events, nothing is done and the return value is 0, indicating success.

This call does not cause flushing of the event queue.

DEFAULTS

All devices are initially disabled for event generation.

Museum

Related Articles