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:

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

 
 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

 
 --------------------------------------------------------------- 
| R|  R|  R|  R|  R|  R|  R|  R|  R|  R|  R|  e|  d|  c|  b|  a| 
|--|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---| 

15                             0

 
 ------------------------------------------------------------------------------- 
| 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_stemsk is not part of any currently supported standard; it is an extension of AT&T System V provided by the Santa Cruz Operation.
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.