XUngrabPointer() XUngrabPointer()
Name
XUngrabPointer - release the pointer from an active grab.
Synopsis
XUngrabPointer(display, time)
Display *display;
Time time;
Arguments
display Specifies a connection to an X server; returned from XOpenDisplay().
time Specifies the time when the grab should take place. Pass either a timestamp, expressed in milliseconds, or the constant Current-
Time. If this time is earlier than the last-pointer-grab time or later than current server time, the pointer will not be
grabbed.
Description
XUngrabPointer() releases an active grab on the pointer by the calling client. It executes as follows:
o Releases the pointer and any queued events, if this client has actively grabbed the pointer from XGrabPointer(), XGrabButton(), or from
a normal button press.
o Does not release the pointer if the specified time is earlier than the last-pointer-grab time or is later than the current X server
time.
o Generates EnterNotify and LeaveNotify events.
The X server performs an XUngrabPointer() automatically if the event_window or confine_to window (arguments of XGrabButton() and XGrab-
Pointer()) becomes not viewable, or if the confine_to window is moved completely outside the root window.
For more information, see Volume One, Chapter 9, The Keyboard and Pointer.
See Also
XChangeActivePointerGrab(), XChangePointerControl(), XGetPointerControl(), XGetPointerMapping(), XGrabPointer(), XQueryPointer(), XSet-
PointerMapping(), XWarpPointer().
Xlib - Pointer XUngrabPointer()
