summaryrefslogtreecommitdiff
path: root/man/XGrabDeviceButton.man
diff options
context:
space:
mode:
Diffstat (limited to 'man/XGrabDeviceButton.man')
-rw-r--r--man/XGrabDeviceButton.man211
1 files changed, 0 insertions, 211 deletions
diff --git a/man/XGrabDeviceButton.man b/man/XGrabDeviceButton.man
deleted file mode 100644
index 57e1f9e..0000000
--- a/man/XGrabDeviceButton.man
+++ /dev/null
@@ -1,211 +0,0 @@
-.\"
-.\" $XFree86: xc/doc/man/Xi/XGrDvBut.man,v 1.2 2001/01/27 18:20:21 dawes Exp $
-.\"
-.\"
-.\" 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: XGrDvBut.man,v 1.3 2000/08/17 19:41:56 cpqbld Exp $
-.ds xL Programming With Xlib
-.TH XGrabDeviceButton __LIB_MAN_SUFFIX__ __xorgversion__ "X FUNCTIONS"
-.SH NAME
-XGrabDeviceButton, XUngrabDeviceButton \- grab/ungrab extension input device buttons
-.SH SYNTAX
-\fB
-.nf
-.HP
-int XGrabDeviceButton\^(\^Display *\fIdisplay\fP\^, XDevice *\fIdevice\fP\^,
-unsigned int \fIbutton\fP\^, unsigned int \fImodifiers\fP\^, XDevice
-*\fImodifier_device\fP\^, Window \fIgrab_window\fP\^, Bool
-\fIowner_events\fP\^, unsigned int \fIevent_count\fP\^, XEventClass
-*\fIevent_list\fP\^, int \fIthis_device_mode\fP\^, int
-\fIother_devices_mode\fP\^);
-.HP
-int XUngrabDeviceButton\^(\^Display *\fIdisplay\fP\^, XDevice *\fIdevice\fP\^,
-unsigned int \fIbutton\fP\^, unsigned int \fImodifiers\fP\^, XDevice
-*\fImodifier_device\fP\^, Window \fIgrab_window\fP\^);
-.fi
-\fP
-.SH ARGUMENTS
-.ds Bu grabbed or released
-.TP 12
-.I display
-Specifies the connection to the X server.
-.TP 12
-.I device
-Specifies the device that is to be \*(Bu
-.TP 12
-.I button
-Specifies the device button that is to be \*(Bu or
-\fIAnyButton\fP.
-.TP 12
-.I modifiers
-Specifies the set of keymasks or
-\fIAnyModifier\fP.
-The mask is the bitwise inclusive OR of the valid keymask bits.
-Valid bits are: Shiftmask, LockMask, ControlMask, Mod1Mask, Mod2Mask,
-Mod3Mask, Mod4Mask, Mod5Mask.
-.TP 12
-.I modifier_device
-specifies the device whose modifiers are to be used. If the modifier_device
-specified is NULL, the X keyboard will be used as the modifier_device.
-.TP 12
-.I grab_window
-Specifies the grab window.
-.TP 12
-.I owner_events
-Specifies a Boolean value that indicates whether the device
-events are to be reported as usual or reported with respect to the grab window
-if selected by the event list.
-.TP 12
-.I event_count
-Specifies the number of event classes in the event list.
-.TP 12
-.I event_list
-Specifies which events are reported to the client.
-.TP 12
-.I this_device_mode
-Specifies further processing of events from this device.
-You can pass \fIGrabModeSync\fP or \fIGrabModeAsync\fP.
-.TP 12
-.I other_devices_mode
-Specifies further processing of events from all other devices.
-You can pass \fIGrabModeSync\fP or \fIGrabModeAsync\fP.
-.SH DESCRIPTION
-The \fIXGrabDeviceButton\fP request establishes a passive grab.
-In the future,
-the device is actively grabbed (as for \fIXGrabDevice\fP,
-the last-grab time is set to the time at which the button was pressed
-(as transmitted in the
-\fIDeviceButtonPress\fP
-event), and the
-\fIDeviceButtonPress\fP
-event is reported if all of the following conditions are true:
-.IP \(bu 5
-The device is not grabbed, and the specified button is logically pressed
-when the specified modifier keys are logically down on the specified
-modifier device
-and no other buttons or modifier keys are logically down.
-.IP \(bu 5
-Either the grab window is an ancestor of (or is) the focus window, OR
-the grab window is a descendent of the focus window and contains the
-device.
-.IP \(bu 5
-A passive grab on the same button/modifier combination does not exist
-on any ancestor of grab_window.
-.LP
-The interpretation of the remaining arguments is as for
-\fIXGrabDevice\fP.
-The active grab is terminated automatically when the logical state of the
-device has all buttons released
-(independent of the logical state of the modifier keys).
-.LP
-Note that the logical state of a device (as seen by client applications)
-may lag the physical state if device event processing is frozen.
-.LP
-This request overrides all previous grabs by the same client on the same
-button/modifier combinations on the same window.
-A modifiers of
-\fIAnyModifier\fP
-is equivalent to issuing the grab request for all
-possible modifier combinations (including the combination of no modifiers).
-It is not required that all modifiers specified have currently assigned
-KeyCodes.
-A button of
-\fIAnyButton\fP
-is equivalent to
-issuing the request for all possible buttons.
-Otherwise, it is not required that the specified button currently be assigned
-to a physical button.
-.LP
-A modifier_device of NULL indicates that the X keyboard is to be used as the
-modifier_device.
-.LP
-If some other client has already issued a
-\fIXGrabDeviceButton\fP
-with the same button/modifier combination on the same window, a
-\fIBadAccess\fP
-error results.
-When using
-\fIAnyModifier\fP
-or
-\fIAnyButton\fP ,
-the request fails completely,
-and a
-\fIBadAccess\fP
-error results (no grabs are
-established) if there is a conflicting grab for any combination.
-\fIXGrabDeviceButton\fP
-has no effect on an active grab.
-.LP
-\fIXGrabDeviceButton\fP
-can generate
-\fIBadClass\fP,
-\fIBadDevice\fP,
-\fIBadMatch\fP,
-\fIBadValue\fP,
-and
-\fIBadWindow\fP
-errors.
-.P
-The \fIXUngrabDeviceButton\fP
-request releases the passive grab for a
-button/modifier combination on the specified window if
-it was grabbed by this client.
-A modifier of \fIAnyModifier\fP is
-equivalent to issuing
-the ungrab request for all possible modifier combinations, including
-the combination of no modifiers.
-A button of
-\fIAnyButton\fP
-is equivalent to issuing the
-request for all possible buttons.
-\fIXUngrabDeviceButton\fP
-has no effect on an active grab.
-.LP
-A modifier_device of NULL indicates that the X keyboard should be used as
-the modifier_device.
-.LP
-\fIXUngrabDeviceButton\fP
-can generate
-\fIBadDevice\fP,
-\fIBadMatch\fP,
-\fIBadValue\fP
-and
-\fIBadWindow\fP
-errors.
-.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 the specified device is the X keyboard or X pointer device.
-.TP 12
-\fIBadMatch\fP
-This error may occur if an \fIXGrabDeviceButton\fP request was made
-specifying
-a device that has no buttons, or specifying a modifier device
-that has no keys.
-.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
-A value for a Window argument does not name a defined Window.
-.SH "SEE ALSO"
-XAllowDeviceEvents(3),
-.br
-XGrabDevice(3),
-.br
-XGrabDeviceKey(3),
-.br
-\fI\*(xL\fP