summaryrefslogtreecommitdiff
path: root/man/XChangeDeviceDontPropagateList.man
diff options
context:
space:
mode:
Diffstat (limited to 'man/XChangeDeviceDontPropagateList.man')
-rw-r--r--man/XChangeDeviceDontPropagateList.man104
1 files changed, 104 insertions, 0 deletions
diff --git a/man/XChangeDeviceDontPropagateList.man b/man/XChangeDeviceDontPropagateList.man
new file mode 100644
index 0000000..b3e854e
--- /dev/null
+++ b/man/XChangeDeviceDontPropagateList.man
@@ -0,0 +1,104 @@
+.\"
+.\" Copyright ([\d,\s]*) by Hewlett-Packard Company, Ardent Computer,
+.\"
+.\" Permission to use, copy, modify, distribute, and sell this documentation
+.\" for any purpose and without fee is hereby granted, provided that the above
+.\" copyright notice and this permission notice appear in all copies.
+.\" Ardent, and Hewlett-Packard make no representations about the
+.\" suitability for any purpose of the information in this document. It is
+.\" provided \`\`as is'' without express or implied warranty.
+.\"
+.\" $Xorg: XChProp.man,v 1.4 2001/03/16 17:51:13 pookie Exp $
+.ds xL Programming With Xlib
+.TH XChangeDeviceDontPropagateList 3X11 "Release 6.6" "X Version 11" "X FUNCTIONS"
+.SH NAME
+XChangeDeviceDontPropagateList, XGetDeviceDontPropagateList \- query or change the dont-propagate-list for extension devices
+.SH SYNTAX
+XChangeDeviceDontPropagateList\^(\^\fIdisplay\fP, \fIwindow\fP\^,
+\fIcount\fP\^, \fIevent_list\fP\^, \fImode\fP\^)
+.br
+ Display *\fIdisplay\fP\^;
+.br
+ Window *\fIwindow\fP\^;
+.br
+ int *\fIcount\fP\^;
+.br
+ XEventClass *\fIevent_list\fP\^;
+.br
+ int \fImode\fP\^;
+.br
+XEventClass *XGetDeviceDontPropagateList\^(\^\fIdisplay\fP, \fIwindow\fP\^,
+\fIcount\fP\^)
+.br
+ Display *\fIdisplay\fP\^;
+.br
+ Window *\fIwindow\fP\^;
+.br
+ int *\fIcount\fP\^;
+.SH ARGUMENTS
+.TP 12
+.I display
+Specifies the connection to the X server.
+.TP 12
+.I window
+Specifies the window whose dont-propagate-list is to be queried or modified.
+.TP 12
+.I event_list
+Specifies a pointer to a list of event classes.
+.TP 12
+.I mode
+Specifies the mode.
+You can pass
+\fIAddToList\fP ,
+or
+\fIDeleteFromList\fP.
+.TP 12
+.I count
+Specifies the number of event classes in the list.
+.SH DESCRIPTION
+The \fIXChangeDeviceDontPropagateList\fP request modifies the list
+of events that should not be propagated to ancestors of the event window.
+This request allows extension events to be added to or deleted from
+that list. By default, all events are propagated to ancestor windows.
+Once modified, the list remains modified for the life of the window.
+Events are not removed from the list because the client that added them
+has terminated.
+.LP
+Suppression of event propagation is not allowed for all input extension
+events. If a specified event class is one that cannot be suppressed,
+a \fIBadClass\fP error will result. Events that can be suppressed
+include \fIDeviceKeyPress\fP, \fIDeviceKeyRelease\fP, \fIDeviceButtonPress\fP,
+\fIDeviceButtonRelease\fP, \fIDeviceMotionNotify\fP, \fIProximityIn\fP,
+and \fIProximityOut\fP.
+.LP
+\fIXChangeDeviceDontPropagateList\fP
+can generate a \fIBadDevice\fP, \fIBadClass\fP, or \fIBadValue\fP error.
+.LP
+The \fIXGetDeviceDontPropagateList\fP request queries the list
+of events that should not be propagated to ancestors of the event window.
+.LP
+\fIXGetDeviceDontPropagateList\fP
+can generate a \fIBadClass\fP or \fIBadWindow\fP error.
+.SH DIAGNOSTICS
+.TP 12
+\fIBadDevice\fP
+An invalid device was specified. The specified device does not exist or has
+not been opened by this client via \fIXOpenInputDevice\fP. This error may
+also occur if some other client has caused the specified device to become
+the X keyboard or X pointer device via the \fIXChangeKeyboardDevice\fP or
+\fIXChangePointerDevice\fP requests.
+.TP 12
+\fIBadValue\fP
+Some numeric value falls outside the range of values accepted by the request.
+Unless a specific range is specified for an argument, the full range defined
+by the argument's type is accepted. Any argument defined as a set of
+alternatives can generate this error.
+.TP 12
+\fIBadWindow\fP
+An invalid window id was specified.
+.TP 12
+\fIBadClass\fP
+An invalid event class was specified.
+.SH "SEE ALSO"
+.br
+\fI\*(xL\fP