317 lines
5.8 KiB
HTML
317 lines
5.8 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of XSELECTEXTENSIONEVEN</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>XSELECTEXTENSIONEVEN</H1>
|
|
Section: (3)<BR>Updated: 06/19/2019<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
XSelectExtensionEvent, XGetSelectedExtensionEvents - select extension events, get the list of currently selected extension events
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<P>
|
|
<PRE>
|
|
#include <<A HREF="file:///usr/include/X11/extensions/XInput.h">X11/extensions/XInput.h</A>>
|
|
</PRE>
|
|
|
|
<P>
|
|
<PRE>
|
|
XSelectExtensionEvent( Display *display,
|
|
Window w,
|
|
XEventClass *event_list,
|
|
int event_count);
|
|
</PRE>
|
|
|
|
<P>
|
|
<PRE>
|
|
XGetSelectedExtensionEvents( 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);
|
|
</PRE>
|
|
|
|
<P>
|
|
<PRE>
|
|
display
|
|
Specifies the connection to the X server.
|
|
</PRE>
|
|
|
|
<P>
|
|
<PRE>
|
|
w
|
|
Specifies the window whose events you are interested in.
|
|
</PRE>
|
|
|
|
<P>
|
|
<PRE>
|
|
event_list
|
|
Specifies the list of event classes that describe the
|
|
events you are interested in.
|
|
</PRE>
|
|
|
|
<P>
|
|
<PRE>
|
|
event_count
|
|
Specifies the count of event classes in the event list.
|
|
</PRE>
|
|
|
|
<P>
|
|
<PRE>
|
|
this_client_event_count_return
|
|
Returns the count of event classes selected by this
|
|
client.
|
|
</PRE>
|
|
|
|
<P>
|
|
<PRE>
|
|
this_client_event_list_return
|
|
Returns a pointer to the list of event classes selected
|
|
by this client.
|
|
</PRE>
|
|
|
|
<P>
|
|
<PRE>
|
|
all_clients_event_count_return
|
|
Returns the count of event classes selected by all
|
|
clients.
|
|
</PRE>
|
|
|
|
<P>
|
|
<PRE>
|
|
all_clients_event_list_return
|
|
Returns a pointer to the list of event classes selected
|
|
by all clients.
|
|
</PRE>
|
|
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<P>
|
|
<DL COMPACT><DT id="1"><DD>
|
|
|
|
|
|
|
|
<PRE>
|
|
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 window is not interested in
|
|
a device event, it usually propagates to the closest ancestor
|
|
that is interested, unless the do_not_propagate mask prohibits
|
|
it.
|
|
</PRE>
|
|
|
|
</DL>
|
|
|
|
|
|
|
|
|
|
<P>
|
|
<DL COMPACT><DT id="2"><DD>
|
|
|
|
|
|
|
|
<PRE>
|
|
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 DeviceButtonPress
|
|
event with automatic passive grabbing enabled, which is
|
|
associated with the event class DeviceButtonPressGrab. To
|
|
receive DeviceButtonPress events without automatic passive
|
|
grabbing, use event class DeviceButtonPress but do not
|
|
specify event class DeviceButtonPressGrab.
|
|
</PRE>
|
|
|
|
</DL>
|
|
|
|
|
|
|
|
|
|
<P>
|
|
<DL COMPACT><DT id="3"><DD>
|
|
|
|
|
|
|
|
<PRE>
|
|
The server reports the event to all interested clients.
|
|
</PRE>
|
|
|
|
</DL>
|
|
|
|
|
|
|
|
|
|
<P>
|
|
<DL COMPACT><DT id="4"><DD>
|
|
|
|
|
|
|
|
<PRE>
|
|
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, DeviceKeyRelease,
|
|
DeviceButtonPress, DeviceButtonRelese, DeviceMotionNotify,
|
|
DeviceFocusIn, DeviceFocusOut, ProximityIn, ProximityOut,
|
|
DeviceStateNotify, DeviceMappingNotify, ChangeDeviceNotify,
|
|
DevicePointerMotionHint, DeviceButton1Motion,
|
|
DeviceButton2Motion, DeviceButton3Motion, DeviceButton4Motion,
|
|
DeviceButton5Motion, DeviceButtonMotion, DeviceOwnerGrabButton,
|
|
DeviceButtonPressGrab, and NoExtensionEvent.
|
|
</PRE>
|
|
|
|
</DL>
|
|
|
|
|
|
|
|
|
|
<P>
|
|
<DL COMPACT><DT id="5"><DD>
|
|
|
|
|
|
|
|
<PRE>
|
|
To obtain the proper event class for a particular device, one
|
|
of the above macros is invoked using the XDevice structure for
|
|
that device. For example,
|
|
DeviceKeyPress (*device, type, eventclass);
|
|
</PRE>
|
|
|
|
</DL>
|
|
|
|
|
|
|
|
|
|
<P>
|
|
<DL COMPACT><DT id="6"><DD>
|
|
|
|
|
|
|
|
<PRE>
|
|
returns the DeviceKeyPress event type and the eventclass for
|
|
selecting DeviceKeyPress events from this device.
|
|
</PRE>
|
|
|
|
</DL>
|
|
|
|
|
|
|
|
|
|
<P>
|
|
<DL COMPACT><DT id="7"><DD>
|
|
|
|
|
|
|
|
<PRE>
|
|
XSelectExtensionEvent can generate a BadWindow or BadClass
|
|
error. The XGetSelectedExtensionEvents request reports the
|
|
extension events selected by this client and all clients for
|
|
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.
|
|
</PRE>
|
|
|
|
</DL>
|
|
|
|
|
|
|
|
|
|
<P>
|
|
<DL COMPACT><DT id="8"><DD>
|
|
|
|
|
|
|
|
<PRE>
|
|
XGetSelectedExtensionEvents can generate a BadWindow error.
|
|
</PRE>
|
|
|
|
</DL>
|
|
|
|
|
|
|
|
|
|
<A NAME="lbAE"> </A>
|
|
<H2>DIAGNOSTICS</H2>
|
|
|
|
<P>
|
|
<DL COMPACT><DT id="9"><DD>
|
|
|
|
|
|
|
|
<PRE>
|
|
BadWindow
|
|
A value for a Window argument does not name a defined
|
|
window.
|
|
</PRE>
|
|
|
|
</DL>
|
|
|
|
|
|
|
|
|
|
<P>
|
|
<DL COMPACT><DT id="10"><DD>
|
|
|
|
|
|
|
|
<PRE>
|
|
BadClass
|
|
A value for an XEventClass is invalid.
|
|
</PRE>
|
|
|
|
</DL>
|
|
|
|
|
|
|
|
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="11"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="12"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="13"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="14"><A HREF="#lbAE">DIAGNOSTICS</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:06:01 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|