2 .\" Title: xchangedevicedontpropagatelist
3 .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
4 .\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
6 .\" Manual: [FIXME: manual]
7 .\" Source: [FIXME: source]
10 .TH "XCHANGEDEVICEDONTPRO" "libmansuffix" "09/23/2011" "[FIXME: source]" "[FIXME: manual]"
11 .\" -----------------------------------------------------------------
12 .\" * Define some portability stuff
13 .\" -----------------------------------------------------------------
14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15 .\" http://bugs.debian.org/507673
16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
20 .\" -----------------------------------------------------------------
21 .\" * set default formatting
22 .\" -----------------------------------------------------------------
23 .\" disable hyphenation
25 .\" disable justification (adjust text to left margin only)
27 .\" -----------------------------------------------------------------
28 .\" * MAIN CONTENT STARTS HERE *
29 .\" -----------------------------------------------------------------
31 XChangeDeviceDontPropagateList, XGetDeviceDontPropagateList \- query or change the dont\-propagate\-list for extension devices
35 #include <X11/extensions/XInput\&.h>
39 int XChangeDeviceDontPropagateList( Display *display,
42 XEventClass *event_list,
47 XEventClass* XGetDeviceDontPropagateList( Display *display,
54 Specifies the connection to the X server\&.
59 Specifies the window whose dont\-propagate\-list is to be
60 queried or modified\&.
65 Specifies a pointer to a list of event classes\&.
70 Specifies the mode\&.You can pass AddToList, or
76 Specifies the number of event classes in the list\&.
84 The XChangeDeviceDontPropagateList request modifies the list of
85 events that should not be propagated to ancestors of the event
86 window\&. This request allows extension events to be added to or
87 deleted from that list\&. By default, all events are propagated
88 to ancestor windows\&. Once modified, the list remains modified
89 for the life of the window\&. Events are not removed from the
90 list because the client that added them has terminated\&.
100 Suppression of event propagation is not allowed for all input
101 extension events\&. If a specified event class is one that cannot
102 be suppressed, a BadClass error will result\&. Events that can be
103 suppressed include DeviceKeyPress, DeviceKeyRelease,
104 DeviceButtonPress, DeviceButtonRelease, DeviceMotionNotify,
105 ProximityIn, and ProximityOut\&.
115 XChangeDeviceDontPropagateList can generate a BadDevice,
116 BadClass, or BadValue error\&.
126 The XGetDeviceDontPropagateList request queries the list of
127 events that should not be propagated to ancestors of the event
138 XGetDeviceDontPropagateList can generate a BadClass or
151 An invalid device was specified\&. The specified device
152 does not exist or has not been opened by this client via
153 XOpenInputDevice\&. This error may also occur if some
154 other client has caused the specified device to become
155 the X keyboard or X pointer device via the
156 XChangeKeyboardDevice or XChangePointerDevice requests\&.
167 Some numeric value falls outside the range of values
168 accepted by the request\&. Unless a specific range is
169 specified for an argument, the full range defined by the
170 argument\*(Aqs type is accepted\&. Any argument defined as a
171 set of alternatives can generate this error\&.
182 An invalid window id was specified\&.
193 An invalid event class was specified\&.