XChangeDeviceDontPropagateList(3)

NAME

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

SYNTAX

       int XChangeDeviceDontPropagateList(Display  *display,  Window  *window,
              int *count, XEventClass *event_list, int mode);

       XEventClass *XGetDeviceDontPropagateList(Display *display, Window *win-
              dow, int *count);

ARGUMENTS

       display     Specifies the connection to the X server.

       window      Specifies the window whose  dont-propagate-list  is  to  be
                   queried or modified.

       event_list  Specifies a pointer to a list of event classes.

       mode        Specifies  the  mode.   You can pass AddToList , or Delete-
                   FromList.

       count       Specifies the number of event classes in the list.

DESCRIPTION

       The XChangeDeviceDontPropagateList 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.

       Suppression of event propagation is not allowed for all input extension
       events.  If a specified event class is one that cannot be suppressed, a
       BadClass error will result.  Events  that  can  be  suppressed  include
       DeviceKeyPress,  DeviceKeyRelease,  DeviceButtonPress,  DeviceButtonRe-
       lease, DeviceMotionNotify, ProximityIn, and ProximityOut.

       XChangeDeviceDontPropagateList can generate a BadDevice,  BadClass,  or
       BadValue error.

       The XGetDeviceDontPropagateList request queries the list of events that
       should not be propagated to ancestors of the event window.

       XGetDeviceDontPropagateList  can  generate  a  BadClass   or  BadWindow
       error.

DIAGNOSTICS

       BadDevice   An invalid device was specified.  The specified device does
                   not exist or has not been opened by this client via  XOpen-
                   InputDevice.   This  error  may  also  occur  if some other
                   client has caused the specified device to become the X key-
                   board  or X pointer device via the XChangeKeyboardDevice or
                   XChangePointerDevice requests.

       BadValue    Some numeric  value  falls  outside  the  range  of  values
                   accepted by the request.  Unless a specific range is speci-
                   fied for an argument, the full range defined by  the  argu-
                   ment's  type is accepted.  Any argument defined as a set of
                   alternatives can generate this error.

       BadWindow   An invalid window id was specified.

       BadClass    An invalid event class was specified.

SEE ALSO

       Programming With Xlib

X Version 11 libXi 1.XChangeDeviceDontPropagateList(3X11)