DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH
 

ev_setemask(S)


ev_setemask -- sets event mask

Syntax

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.

See also

ev_block(S), ev_close(S), ev_count(S), ev_flush(S), ev_getdev(S), ev_getemask(S), ev_gindev(S), ev_init(S), ev_open(S), ev_pop(S), ev_read(S), ev_resume(S), ev_suspend(S)

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.
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003