1XChangeDeviceDontPropagateList(3) X FUNCTIONSXChangeDeviceDontPropagateList(3)
2
3
4

NAME

6       XChangeDeviceDontPropagateList,  XGetDeviceDontPropagateList - query or
7       change the dont-propagate-list for extension devices
8

SYNTAX

10       int XChangeDeviceDontPropagateList(Display  *display,  Window  *window,
11              int *count, XEventClass *event_list, int mode);
12
13       XEventClass *XGetDeviceDontPropagateList(Display *display, Window *win‐
14              dow, int *count);
15

ARGUMENTS

17       display     Specifies the connection to the X server.
18
19       window      Specifies the window whose  dont-propagate-list  is  to  be
20                   queried or modified.
21
22       event_list  Specifies a pointer to a list of event classes.
23
24       mode        Specifies  the  mode.   You can pass AddToList , or Delete‐
25                   FromList.
26
27       count       Specifies the number of event classes in the list.
28

DESCRIPTION

30       The XChangeDeviceDontPropagateList request modifies the list of  events
31       that  should  not be propagated to ancestors of the event window.  This
32       request allows extension events to be added to  or  deleted  from  that
33       list.  By default, all events are propagated to ancestor windows.  Once
34       modified, the list remains modified for the life of the window.  Events
35       are  not  removed  from the list because the client that added them has
36       terminated.
37
38       Suppression of event propagation is not allowed for all input extension
39       events.  If a specified event class is one that cannot be suppressed, a
40       BadClass error will result.  Events  that  can  be  suppressed  include
41       DeviceKeyPress,  DeviceKeyRelease,  DeviceButtonPress,  DeviceButtonRe‐
42       lease, DeviceMotionNotify, ProximityIn, and ProximityOut.
43
44       XChangeDeviceDontPropagateList can generate a BadDevice,  BadClass,  or
45       BadValue error.
46
47       The XGetDeviceDontPropagateList request queries the list of events that
48       should not be propagated to ancestors of the event window.
49
50       XGetDeviceDontPropagateList  can  generate  a  BadClass   or  BadWindow
51       error.
52

DIAGNOSTICS

54       BadDevice   An invalid device was specified.  The specified device does
55                   not exist or has not been opened by this client via  XOpen‐
56                   InputDevice.   This  error  may  also  occur  if some other
57                   client has caused the specified device to become the X key‐
58                   board  or X pointer device via the XChangeKeyboardDevice or
59                   XChangePointerDevice requests.
60
61       BadValue    Some numeric  value  falls  outside  the  range  of  values
62                   accepted by the request.  Unless a specific range is speci‐
63                   fied for an argument, the full range defined by  the  argu‐
64                   ment's  type is accepted.  Any argument defined as a set of
65                   alternatives can generate this error.
66
67       BadWindow   An invalid window id was specified.
68
69       BadClass    An invalid event class was specified.
70

SEE ALSO

72       Programming With Xlib
73
74
75
76X Version 11                      libXi 1.1.1XChangeDeviceDontPropagateList(3)
Impressum