2
.\" $XFree86: xc/doc/man/Xi/XChProp.man,v 1.2 2001/01/27 18:20:21 dawes Exp $
5
.\" Copyright ([\d,\s]*) by Hewlett-Packard Company, Ardent Computer,
7
.\" Permission to use, copy, modify, distribute, and sell this documentation
8
.\" for any purpose and without fee is hereby granted, provided that the above
9
.\" copyright notice and this permission notice appear in all copies.
10
.\" Ardent, and Hewlett-Packard make no representations about the
11
.\" suitability for any purpose of the information in this document. It is
12
.\" provided \`\`as is'' without express or implied warranty.
14
.\" $Xorg: XChProp.man,v 1.3 2000/08/17 19:41:56 cpqbld Exp $
15
.ds xL Programming With Xlib
16
.TH XChangeDeviceDontPropagateList __LIB_MAN_SUFFIX__ __xorgversion__ "X FUNCTIONS"
18
XChangeDeviceDontPropagateList, XGetDeviceDontPropagateList \- query or change the dont-propagate-list for extension devices
21
int XChangeDeviceDontPropagateList\^(\^Display *\fIdisplay\fP\^, Window
22
*\fIwindow\fP\^, int *\fIcount\fP\^, XEventClass *\fIevent_list\fP\^, int
25
XEventClass *XGetDeviceDontPropagateList\^(\^Display *\fIdisplay\fP\^, Window
26
*\fIwindow\fP\^, int *\fIcount\fP\^);
30
Specifies the connection to the X server.
33
Specifies the window whose dont-propagate-list is to be queried or modified.
36
Specifies a pointer to a list of event classes.
46
Specifies the number of event classes in the list.
48
The \fIXChangeDeviceDontPropagateList\fP request modifies the list
49
of events that should not be propagated to ancestors of the event window.
50
This request allows extension events to be added to or deleted from
51
that list. By default, all events are propagated to ancestor windows.
52
Once modified, the list remains modified for the life of the window.
53
Events are not removed from the list because the client that added them
56
Suppression of event propagation is not allowed for all input extension
57
events. If a specified event class is one that cannot be suppressed,
58
a \fIBadClass\fP error will result. Events that can be suppressed
59
include \fIDeviceKeyPress\fP, \fIDeviceKeyRelease\fP, \fIDeviceButtonPress\fP,
60
\fIDeviceButtonRelease\fP, \fIDeviceMotionNotify\fP, \fIProximityIn\fP,
61
and \fIProximityOut\fP.
63
\fIXChangeDeviceDontPropagateList\fP
64
can generate a \fIBadDevice\fP, \fIBadClass\fP, or \fIBadValue\fP error.
66
The \fIXGetDeviceDontPropagateList\fP request queries the list
67
of events that should not be propagated to ancestors of the event window.
69
\fIXGetDeviceDontPropagateList\fP
70
can generate a \fIBadClass\fP or \fIBadWindow\fP error.
74
An invalid device was specified. The specified device does not exist or has
75
not been opened by this client via \fIXOpenInputDevice\fP. This error may
76
also occur if some other client has caused the specified device to become
77
the X keyboard or X pointer device via the \fIXChangeKeyboardDevice\fP or
78
\fIXChangePointerDevice\fP requests.
81
Some numeric value falls outside the range of values accepted by the request.
82
Unless a specific range is specified for an argument, the full range defined
83
by the argument's type is accepted. Any argument defined as a set of
84
alternatives can generate this error.
87
An invalid window id was specified.
90
An invalid event class was specified.
2
.\" Title: xchangedevicedontpropagatelist
3
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
4
.\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
6
.\" Manual: [FIXME: manual]
7
.\" Source: [FIXME: source]
10
.TH "XCHANGEDEVICEDONTPRO" "libmansuffix" "10/02/2009" "[FIXME: source]" "[FIXME: manual]"
11
.\" -----------------------------------------------------------------
12
.\" * set default formatting
13
.\" -----------------------------------------------------------------
14
.\" disable hyphenation
16
.\" disable justification (adjust text to left margin only)
18
.\" -----------------------------------------------------------------
19
.\" * MAIN CONTENT STARTS HERE *
20
.\" -----------------------------------------------------------------
22
XChangeDeviceDontPropagateList, XGetDeviceDontPropagateList \- query or change the dont\-propagate\-list for extension devices
26
#include <X11/extensions/XInput\&.h>
30
int XChangeDeviceDontPropagateList( Display *display,
33
XEventClass *event_list,
38
XEventClass* XGetDeviceDontPropagateList( Display *display,
45
Specifies the connection to the X server\&.
50
Specifies the window whose dont\-propagate\-list is to be
51
queried or modified\&.
56
Specifies a pointer to a list of event classes\&.
61
Specifies the mode\&.You can pass AddToList, or
67
Specifies the number of event classes in the list\&.
75
The XChangeDeviceDontPropagateList request modifies the list of
76
events that should not be propagated to ancestors of the event
77
window\&. This request allows extension events to be added to or
78
deleted from that list\&. By default, all events are propagated
79
to ancestor windows\&. Once modified, the list remains modified
80
for the life of the window\&. Events are not removed from the
81
list because the client that added them has terminated\&.
91
Suppression of event propagation is not allowed for all input
92
extension events\&. If a specified event class is one that cannot
93
be suppressed, a BadClass error will result\&. Events that can be
94
suppressed include DeviceKeyPress, DeviceKeyRelease,
95
DeviceButtonPress, DeviceButtonRelease, DeviceMotionNotify,
96
ProximityIn, and ProximityOut\&.
106
XChangeDeviceDontPropagateList can generate a BadDevice,
107
BadClass, or BadValue error\&.
117
The XGetDeviceDontPropagateList request queries the list of
118
events that should not be propagated to ancestors of the event
129
XGetDeviceDontPropagateList can generate a BadClass or
142
An invalid device was specified\&. The specified device
143
does not exist or has not been opened by this client via
144
XOpenInputDevice\&. This error may also occur if some
145
other client has caused the specified device to become
146
the X keyboard or X pointer device via the
147
XChangeKeyboardDevice or XChangePointerDevice requests\&.
158
Some numeric value falls outside the range of values
159
accepted by the request\&. Unless a specific range is
160
specified for an argument, the full range defined by the
161
argument\'s type is accepted\&. Any argument defined as a
162
set of alternatives can generate this error\&.
173
An invalid window id was specified\&.
184
An invalid event class was specified\&.