XISELECTEVENT(3) libXi XISELECTEVENT(3)NAMEXiSelectEvent - select for generic events on the window.
SYNTAX
#include <X11/extensions/XInput.h>
Status XiSelectEvent(Display *display, Window win, XDevice *device,
Mask mask);
ARGUMENTS
display
Specifies the connection to the X server.
device
The device to select mask for. May be NULL.
mask
Generic event mask.
win
Specifies the window.
DESCRIPTION
Events available through the X Generic Event extension (XGE) cannot be
selected with XSelectExtensionEvent. For these events, XiSelectEvent
must be used.
XiSelectEvent causes the X server to report the events defined by mask
on win. The mask overrides the previously selected event mask. A mask
of zero de-registers win from any generic events.
If device is a valid device, the event mask is selected only for this
device. If device is NULL, the event mask is selected for all devices.
A mask set for a device is stored seperately for the mask for all
devices. Thus, if a mask is set for all devices, it cannot be unset for
a single device. It has to be unset for all devices first by supplying
NULL and then re-set one-by-one for all devices.
XiSelectEvent can generate a BadValue, a BadDevice, and a BadWindow
error.
DIAGNOSIS
BadValue
A value is outside of the permitted range.
BadWindow
A value for a Window argument does not name a defined window.
BadDevice
An invalid device was specified. The device does not exist.
SEE ALSO
XSelectExtensionEvent
AUTHOR
Peter Hutterer
Specification and implementation.
February 14, 2008 XISELECTEVENT(3)