XChangeActivePointerGrab() XChangeActivePointerGrab()
Name
XChangeActivePointerGrab - change the parameters of an active pointer grab.
Synopsis
XChangeActivePointerGrab(display, event_mask, cursor, time)
Display *display;
unsigned int event_mask;
Cursor cursor;
Time time;
Arguments
display Specifies a connection to an X server; returned from XOpenDisplay().
event_mask
Specifies which pointer events are reported to the client. This mask is the bitwise OR of one or more of these pointer event
masks: ButtonPressMask, ButtonReleaseMask, EnterWindowMask, LeaveWindowMask, PointerMotionMask, PointerMotionHintMask, But-
ton1MotionMask, Button2MotionMask, Button3MotionMask, Button4MotionMask, Button5MotionMask, ButtonMotionMask, KeymapStateMask.
cursor Specifies the cursor that is displayed. A value of None will keep the current cursor.
time Specifies the time when the grab should take place. Pass either a timestamp, expressed in milliseconds, or the constant Current-
Time.
Description
XChangeActivePointerGrab() changes the characteristics of an active pointer grab, if the specified time is no earlier than the last pointer
grab time and no later than the current X server time. XChangeActivePointerGrab() has no effect on the passive parameters of XGrabBut-
ton().
For more information on pointer grabbing, see Volume One, Chapter 9, The Keyboard and Pointer.
Errors
BadCursor
BadValue The event_mask argument is invalid.
See Also
XChangePointerControl(), XGetPointerControl(), XGetPointerMapping(), XGrabPointer(), XQueryPointer(), XSetPointerMapping(), XUngrab-
Pointer(), XWarpPointer().
Xlib - Pointer XChangeActivePointerGrab()