ev_setemask(3event)

ev_setemask -- sets event mask

Synopsis

cc . . . -levent

#include  <sys/types.h>
#include  <sys/param.h>
#include  <sys/sysmacros.h>
#include  <sys/page.h>
#include  <sys/event.h>
#include  <mouse.h>

int ev_setemask (emask)
emask_t emask;

Description

ev_setemask sets the event mask on an event queue. Events whose tag is not masked-in are prevented from entering an event queue. Event masks are always initialized to allow all events.

The different types of events are:

Type Description

R Reserved

a ``Other'' Device events

b Button events

c String events

d Relative Locator movement events

e Absolute Locator movement events

Type	Description
R	Reserved
a	``Other'' Device events
b	Button events
c	String events
d	Relative Locator movement events
e	Absolute Locator movement events

The bits that make up the mask number have the following definitions:

R R R R R R R R R R R e d c b a

15 0

Diagnostics

If there is no open event queue, -1 is returned. If the new event mask would cause no events to enter the queue, -2 is returned and the event mask is not changed. For example, on a queue with only a mouse, any event mask which did not include D_REL would not allow any events to be entered into the queue.

References

ev_block(3event), ev_close(3event), ev_count(3event), ev_flush(3event), ev_getdev(3event), ev_getemask(3event), ev_gindev(3event), ev_init(3event), ev_open(3event), ev_pop(3event), ev_read(3event), ev_resume(3event),

Standards conformance

ev_setemask is not part of any currently supported standard; it is an extension of AT&T System V provided by the Santa Cruz Operation.