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

displaySpecifies 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, Button1MotionMask, Button2MotionMask, Button3MotionMask, Button4MotionMask, Button5MotionMask, ButtonMotionMask, KeymapStateMask. 

cursorSpecifies the cursor that is displayed.  A value of None will keep the current cursor. 

timeSpecifies the time when the grab should take place.  Pass either a timestamp, expressed in milliseconds, or the constant CurrentTime. 

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 XGrabButton().  For more information on pointer grabbing, see Volume One, Chapter 9, The Keyboard and Pointer. 

Errors

BadCursor

BadValueThe event_mask argument is invalid. 

See Also

XChangePointerControl(), XGetPointerControl(), XGetPointerMapping(), XGrabPointer(), XQueryPointer(), XSetPointerMapping(), XUngrabPointer(), XWarpPointer(). 

Copyright O’Reilly & Assoc.  —