XChangeActivePointerGrab

Syntax

XChangeActivePointerGrab(display, event_mask, cursor, time)
      Display *display;
      unsigned int event_mask;
      Cursor cursor;
      Time time;

Arguments

display Specifies the connection to the X server.
event_mask Specifies which pointer events are reported to the client. The mask is the bitwise inclusive OR of the valid pointer event mask bits.
cursor Specifies the cursor that is to be displayed or None.
time Specifies the time. You can pass either a timestamp or CurrentTime.

Description

The XChangeActivePointerGrab() function changes the specified dynamic parameters if the pointer is actively grabbed by the client and if the specified time is no earlier than the last-pointer-grab time and no later than the current X server time. This function has no effect on the passive parameters of a XGrabButton(). The interpretation of event_mask and cursor is the same as described in XGrabPointer().

XChangeActivePointerGrab() can generate BadCursor and BadValue errors.

Diagnostics

BadCursor A value for a Cursor argument does not name a defined Cursor.
BadValue 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.

See also

XAllowEvents(), XGrabButton(), XGrabKey(), XGrabKeyboard(), XGrabPointer(), XUngrabPointer(), "Pointer Grabbing".
Christophe Tronche, ch.tronche@computer.org