1c27c18e8SmrgXCHANGEDEVICEDONTPROPAGATELIST(libmansuffix) 2c27c18e8Smrg============================================ 3c27c18e8Smrg 4c27c18e8SmrgNAME 5c27c18e8Smrg---- 6c27c18e8Smrg 7c27c18e8Smrg XChangeDeviceDontPropagateList, XGetDeviceDontPropagateList - 8c27c18e8Smrg query or change the dont-propagate-list for extension devices 9c27c18e8Smrg 10c27c18e8SmrgSYNOPSIS 11c27c18e8Smrg-------- 12c27c18e8Smrg 13c27c18e8Smrg #include <X11/extensions/XInput.h> 14c27c18e8Smrg 15c27c18e8Smrg int XChangeDeviceDontPropagateList( Display *display, 16c27c18e8Smrg Window window, 17c27c18e8Smrg int count, 18c27c18e8Smrg XEventClass *event_list, 19c27c18e8Smrg int mode); 20c27c18e8Smrg 21c27c18e8Smrg XEventClass* XGetDeviceDontPropagateList( Display *display, 22c27c18e8Smrg Window window, 23c27c18e8Smrg int *count); 24c27c18e8Smrg 25c27c18e8Smrg display 26c27c18e8Smrg Specifies the connection to the X server. 27c27c18e8Smrg 28c27c18e8Smrg window 29c27c18e8Smrg Specifies the window whose dont-propagate-list is to be 30c27c18e8Smrg queried or modified. 31c27c18e8Smrg 32c27c18e8Smrg event_list 33c27c18e8Smrg Specifies a pointer to a list of event classes. 34c27c18e8Smrg 35c27c18e8Smrg mode 364940c694Smrg Specifies the mode. You can pass AddToList, or 37c27c18e8Smrg DeleteFromList. 38c27c18e8Smrg 39c27c18e8Smrg count 40c27c18e8Smrg Specifies the number of event classes in the list. 41c27c18e8Smrg 42c27c18e8SmrgDESCRIPTION 43c27c18e8Smrg----------- 44c27c18e8Smrg 45c27c18e8Smrg The XChangeDeviceDontPropagateList request modifies the list of 46c27c18e8Smrg events that should not be propagated to ancestors of the event 47c27c18e8Smrg window. This request allows extension events to be added to or 48c27c18e8Smrg deleted from that list. By default, all events are propagated 49c27c18e8Smrg to ancestor windows. Once modified, the list remains modified 50c27c18e8Smrg for the life of the window. Events are not removed from the 51c27c18e8Smrg list because the client that added them has terminated. 52c27c18e8Smrg 53c27c18e8Smrg Suppression of event propagation is not allowed for all input 54c27c18e8Smrg extension events. If a specified event class is one that cannot 55c27c18e8Smrg be suppressed, a BadClass error will result. Events that can be 56c27c18e8Smrg suppressed include DeviceKeyPress, DeviceKeyRelease, 57c27c18e8Smrg DeviceButtonPress, DeviceButtonRelease, DeviceMotionNotify, 58c27c18e8Smrg ProximityIn, and ProximityOut. 59c27c18e8Smrg 60c27c18e8Smrg XChangeDeviceDontPropagateList can generate a BadDevice, 61c27c18e8Smrg BadClass, or BadValue error. 62c27c18e8Smrg 63c27c18e8Smrg The XGetDeviceDontPropagateList request queries the list of 64c27c18e8Smrg events that should not be propagated to ancestors of the event 65c27c18e8Smrg window. 66c27c18e8Smrg 67c27c18e8Smrg XGetDeviceDontPropagateList can generate a BadClass or 68c27c18e8Smrg BadWindow error. 69c27c18e8Smrg 70c27c18e8SmrgDIAGNOSTICS 71c27c18e8Smrg----------- 72c27c18e8Smrg 73c27c18e8Smrg BadDevice 74c27c18e8Smrg An invalid device was specified. The specified device 75c27c18e8Smrg does not exist or has not been opened by this client via 76c27c18e8Smrg XOpenInputDevice. This error may also occur if some 77c27c18e8Smrg other client has caused the specified device to become 78c27c18e8Smrg the X keyboard or X pointer device via the 79c27c18e8Smrg XChangeKeyboardDevice or XChangePointerDevice requests. 80c27c18e8Smrg 81c27c18e8Smrg BadValue 82c27c18e8Smrg Some numeric value falls outside the range of values 83c27c18e8Smrg accepted by the request. Unless a specific range is 84c27c18e8Smrg specified for an argument, the full range defined by the 85c27c18e8Smrg argument's type is accepted. Any argument defined as a 86c27c18e8Smrg set of alternatives can generate this error. 87c27c18e8Smrg 88c27c18e8Smrg BadWindow 89c27c18e8Smrg An invalid window id was specified. 90c27c18e8Smrg 91c27c18e8Smrg BadClass 92c27c18e8Smrg An invalid event class was specified. 93