NAME
XIDefineCursor, XIUndefineCursor - define device cursors.
SYNOPSIS
#include <X11/extensions/XInput2.h>
int XIDefineCursor( Display *display,
int deviceid,
Window win,
Cursor cursor);
int XIUndefineCursor( Display *display,
int deviceid,
Window win);
cursor
Specifies the cursor that is to be displayed or None.
deviceid
Specifies the device whose cursor is to change.
display
Specifies the connection to the X server.
win
Specifies the window.
DESCRIPTION
If a cursor is set, it will be used when the device´s pointer
is in the window. If the cursor is None, it is equivalent to
XIUndefineCursor.
The deviceid must be a master pointer device or a BadDevice error is
returned.
XIDefineCursor can generate BadDevice, BadCursor and BadWindow.
The XIUndefineCursor function undoes the effect of a previous
XIDefineCursor for this window. When the pointer is in the
window, the window´s default cursor will now be used. If no
default cursor is defined, the parent´s cursor for this device
will be used (if defined) or the parent´s default cursor will
be used.
XIDefineCursor and XIUndefineCursor are identical to
XDefineCursor and XUndefineCursor but specify the device
explicitly.
XIUndefineCursor can generate a BadDevice and a BadWindow
error.
DIAGNOSTICS
BadCursor
A value for a cursor argument does not name a defined
cursor.
BadDevice
An invalid device was specified. The device does not
exist or is not a pointer device.
BadWindow
A value for a Window argument does not name a defined
window.
See also
XDefineCursor, XUndefineCursor
[FIXME: source] 10/02/2009 XIDEFINECURSOR(3)