XSelectExtensionEvent(3X11)X FUNCTIONSXSelectExtensionEvent(3X11)
XSelectExtensionEvent, XGetSelectedExtensionEvents - select
extension events, get the list of currently selected exten-
sion events
XSelectExtensionEvent(display, w, event_list, event_count)
Display *display;
Window w;
XEventClass *event_list;
int event_count;
XGetSelectedExtensionEvents(display, w,
this_client_event_count_return,
this_client_event_list_return,
all_clients_event_count_return,
all_clients_event_list_return)
Display *display;
Window w;
int this_client_event_count_return;
XEventClass *this_client_event_list_return;
int all_clients_event_count_return;
XEventClass *all_clients_event_list_return;
display Specifies the connection to the X server.
w Specifies the window whose events you are
interested in.
event_list Specifies the list of event classes that
describe the events you are interested in.
event_count Specifies the count of event classes in the
event list.
this_client_event_count_return
Returns the count of event classes selected by
this client.
this_client_event_list_return
Returns a pointer to the list of event classes
selected by this client.
all_clients_event_count_return
Returns the count of event classes selected by
all clients.
all_clients_event_list_return
Returns a pointer to the list of event classes
selected by all clients.
XFree86 Version 4.5.0 1
XSelectExtensionEvent(3X11)X FUNCTIONSXSelectExtensionEvent(3X11)
The XSelectExtensionEvent request causes the X server to
report the events associated with the specified list of
event classes. Initially, X will not report any of these
events. Events are reported relative to a window. If a win-
dow is not interested in a device event, it usually pro-
pagates to the closest ancestor that is interested, unless
the do_not_propagate mask prohibits it.
Multiple clients can select for the same events on the same
window with the following restrictions:
+ Multiple clients can select events on the same window
because their event masks are disjoint. When the X
server generates an event, it reports it to all
interested clients.
+ Only one client at a time can select a DeviceBut-
tonPress event with automatic passive grabbing enabled,
which is associated with the event class DeviceBut-
tonPressGrab. To receive DeviceButtonPress events
without automatic passive grabbing, use event class
DeviceButtonPress but do not specify event class Devi-
ceButtonPressGrab.
The server reports the event to all interested clients.
Information contained in the XDevice structure returned by
XOpenDevice is used by macros to obtain the event classes
that clients use in making XSelectExtensionEvent requests.
Currently defined macros include DeviceKeyPress, Devi-
ceKeyRelease, DeviceButtonPress, DeviceButtonRelese, Devi-
ceMotionNotify, DeviceFocusIn, DeviceFocusOut, ProximityIn,
ProximityOut, DeviceStateNotify, DeviceMappiingNotify,
ChangeDeviceNotify, DevicePointerMotionHint,
DeviceButton1Motion, DeviceButton2Motion,
DeviceButton3Motion, DeviceButton4Motion,
DeviceButton5Motion, DeviceButtonMotion, DeviceOwnerGrabBut-
ton, DeviceButtonPressGrab, and NoExtensionEvent.
To obtain the proper event class for a particular device,
one of the above macros is invoked using the XDevice struc-
ture for that device. For example,
DeviceKeyPress (*device, type, eventclass);
returns the DeviceKeyPress event type and the eventclass for
selecting DeviceKeyPress events from this device.
XSelectExtensionEvent can generate a BadWindow or BadClass
error. The XGetSelectedExtensionEvents request reports the
extension events selected by this client and all clients for
XFree86 Version 4.5.0 2
XSelectExtensionEvent(3X11)X FUNCTIONSXSelectExtensionEvent(3X11)
the specified window. This request returns pointers to two
XEventClass arrays. One lists the input extension events
selected by this client from the specified window. The
other lists the event classes selected by all clients from
the specified window. You should use XFree to free these
two arrays.
XGetSelectedExtensionEvents can generate a BadWindow error.
BadWindow A value for a Window argument does not name a
defined Window.
BadClass A value for an XEventClass argument is invalid.
Programming with Xlib
XFree86 Version 4.5.0 3
Generated on 2012-02-20 02:47:02 by $MirOS: src/scripts/roff2htm,v 1.70 2011/12/03 18:21:12 tg Exp $
These manual pages and other documentation are copyrighted by their respective writers;
their source is available at our CVSweb,
AnonCVS, and other mirrors. The rest is Copyright © 2002‒2011 The MirOS Project, Germany.
This product includes material
provided by Thorsten Glaser.
This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report – diffs preferred.