diff options
Diffstat (limited to 'man/XSelectExtensionEvent.man')
-rw-r--r-- | man/XSelectExtensionEvent.man | 151 |
1 files changed, 0 insertions, 151 deletions
diff --git a/man/XSelectExtensionEvent.man b/man/XSelectExtensionEvent.man deleted file mode 100644 index 75a3d68..0000000 --- a/man/XSelectExtensionEvent.man +++ /dev/null @@ -1,151 +0,0 @@ -.\" -.\" $XFree86$ -.\" -.\" -.\" 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: XSelExtEv.man,v 1.3 2000/08/17 19:41:57 cpqbld Exp $ -.ds xL Programming with Xlib -.TH XSelectExtensionEvent __LIB_MAN_SUFFIX__ __xorgversion__ "X FUNCTIONS" -.SH NAME -XSelectExtensionEvent, XGetSelectedExtensionEvents \- select extension events, get the list of currently selected extension events -.SH SYNTAX -XSelectExtensionEvent\^(\^\fIdisplay\fP, \fIw\fP\^, \fIevent_list\fP\^, \fIevent_count\fP\^) -.br - Display *\fIdisplay\fP\^; -.br - Window \fIw\fP\^; -.br - XEventClass *\fIevent_list\fP\^; -.br - int \fIevent_count\fP\^; -.sp -XGetSelectedExtensionEvents\^(\^\fIdisplay\fP, \fIw\fP\^, \fIthis_client_event_count_return\fP\^, -.br -\fIthis_client_event_list_return\fP\^, \fIall_clients_event_count_return\fP\^, -\fIall_clients_event_list_return\fP\^) -.br - Display *\fIdisplay\fP\^; -.br - Window \fIw\fP\^; -.br - int \fIthis_client_event_count_return\fP\^; -.br - XEventClass *\fIthis_client_event_list_return\fP\^; -.br - int \fIall_clients_event_count_return\fP\^; -.br - XEventClass *\fIall_clients_event_list_return\fP\^; -.SH ARGUMENTS -.TP 12 -.I display -Specifies the connection to the X server. -.ds Wi whose events you are interested in -.TP 12 -.I w -Specifies the window \*(Wi. -.TP 12 -.I event_list -Specifies the list of event classes that describe the events you are interested in. -.TP 12 -.I event_count -Specifies the count of event classes in the event list. -.TP 12 -.I this_client_event_count_return -Returns the count of event classes selected by this client. -.TP 12 -.I this_client_event_list_return -Returns a pointer to the list of event classes selected by this client. -.TP 12 -.I all_clients_event_count_return -Returns the count of event classes selected by all clients. -.TP 12 -.I all_clients_event_list_return -Returns a pointer to the list of event classes selected by all clients. -.SH DESCRIPTION -The -\fIXSelectExtensionEvent\fP 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. -.LP -Multiple clients can select for the same events on the same window -with the following restrictions: -.IP \(bu 5 -Multiple clients can select events on the same window because their event masks -are disjoint. -When the X server generates an event, it reports it -to all interested clients. -.IP \(bu 5 -Only one client at a time can select a -\fIDeviceButtonPress\fP -event with automatic passive grabbing enabled, which is associated with -the event class \fIDeviceButtonPressGrab\fP. -To receive \fIDeviceButtonPress\fP events without automatic passive -grabbing, use event class \fIDeviceButtonPress\fP but do not specify -event class \fIDeviceButtonPressGrab\fP. -.LP -The server reports the event to all interested clients. -.LP -Information contained in the \fIXDevice\fP structure returned by -\fIXOpenDevice\fP is used -by macros to obtain the event classes that clients use in making -\fIXSelectExtensionEvent\fP requests. Currently defined macros include -\fIDeviceKeyPress\fP, \fIDeviceKeyRelease\fP, \fIDeviceButtonPress\fP, -\fIDeviceButtonRelese\fP, \fIDeviceMotionNotify\fP, \fIDeviceFocusIn\fP, -\fIDeviceFocusOut\fP, \fIProximityIn\fP, \fIProximityOut\fP, -\fIDeviceStateNotify\fP, \fIDeviceMappiingNotify\fP, -\fIChangeDeviceNotify\fP, \fIDevicePointerMotionHint\fP, -\fIDeviceButton1Motion\fP, \fIDeviceButton2Motion\fP, \fIDeviceButton3Motion\fP, -\fIDeviceButton4Motion\fP, \fIDeviceButton5Motion\fP, \fIDeviceButtonMotion\fP, -\fIDeviceOwnerGrabButton\fP, \fIDeviceButtonPressGrab\fP, and -\fINoExtensionEvent\fP. -.LP -To obtain the proper event class for a particular device, one of the above -macros is invoked using the \fIXDevice\fP structure for that device. For -example, -.LP -.DS 0 -.TA .5i -.ta .5i -DeviceKeyPress (*device, type, eventclass); -.DE -.LP -returns the \fIDeviceKeyPress\fP event type and the eventclass for selecting -\fIDeviceKeyPress\fP events from this device. -.LP -\fIXSelectExtensionEvent\fP -can generate a \fIBadWindow\fP or \fIBadClass\fP error. -The -\fIXGetSelectedExtensionEvents\fP -request reports the extension events selected by this client and all clients -for the specified window. This request returns pointers to two -\fIXEventClass\fP -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 \fIXFree\fP to free these -two arrays. -.LP -\fIXGetSelectedExtensionEvents\fP -can generate a \fIBadWindow\fP error. -.SH DIAGNOSTICS -.TP 12 -\fIBadWindow\fP -A value for a Window argument does not name a defined Window. -.TP 12 -\fIBadClass\fP -A value for an XEventClass argument is invalid. -.SH "SEE ALSO" -.br -\fI\*(xL\fP |