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

 +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
 |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.
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004