Copyright (C) 2000-2012 |
Manpages XSelectExtensionEventSection: X FUNCTIONS (3X11)Updated: Release 6.5 Index Return to Main Contents NAMEXSelectExtensionEvent, XGetSelectedExtensionEvents - select extension events, get the list of currently selected extension eventsSYNTAXXSelectExtensionEvent(display, w, event_list, event_count)Display *display; Window w; XEventClass *event_list; int event_count;
XGetSelectedExtensionEvents(display, w, this_client_event_count_return,
ARGUMENTS
DESCRIPTIONThe XSelectExtensionEvent request causes the X server to report the events associated with the specified list of event classes. Initially, X will not report any of these events. Events are reported relative to a window. If a window is not interested in a device event, it usually propagates to the closest ancestor that is interested, unless the do_not_propagate mask prohibits it.Multiple clients can select for the same events on the same window with the following restrictions:
The server reports the event to all interested clients. Information contained in the XDevice structure returned by XOpenDevice is used by macros to obtain the event classes that clients use in making XSelectExtensionEvent requests. Currently defined macros include DeviceKeyPress, DeviceKeyRelease, DeviceButtonPress, DeviceButtonRelese, DeviceMotionNotify, DeviceFocusIn, DeviceFocusOut, ProximityIn, ProximityOut, DeviceStateNotify, DeviceMappiingNotify, ChangeDeviceNotify, DevicePointerMotionHint, DeviceButton1Motion, DeviceButton2Motion, DeviceButton3Motion, DeviceButton4Motion, DeviceButton5Motion, DeviceButtonMotion, DeviceOwnerGrabButton, DeviceButtonPressGrab, and NoExtensionEvent. To obtain the proper event class for a particular device, one of the above macros is invoked using the XDevice structure for that device. For example, DeviceKeyPress (*device, type, eventclass); returns the DeviceKeyPress event type and the eventclass for selecting DeviceKeyPress events from this device. XSelectExtensionEvent can generate a BadWindow or BadClass error. The XGetSelectedExtensionEvents request reports the extension events selected by this client and all clients for the specified window. This request returns pointers to two XEventClass arrays. One lists the input extension events selected by this client from the specified window. The other lists the event classes selected by all clients from the specified window. You should use XFree to free these two arrays. XGetSelectedExtensionEvents can generate a BadWindow error. DIAGNOSTICS
SEE ALSOProgramming with Xlib
IndexThis document was created by man2html, using the manual pages. Time: 12:04:05 GMT, April 25, 2024 |