XDEFINEDEVICECURSOR,(3) libXi XDEFINEDEVICECURSOR,(3)
NAME
XDefineDeviceCursor, XUndefineDeviceCursor - define device cursors.
SYNTAX
#include <X11/extensions/XInput.h>
int XDefineCursor(Display *display, XDevice *device, Window win,
Cursor cursor);
int XUndefineCursor(Display *display, XDevice *device, Window win);
ARGUMENTS
cursor
Specifies the cursor that is to be displayed or None.
device
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
XUndefineDefineCursor.
XDefineDeviceCursor can generate BadCursor and BadWindow.
The XUndefineDeviceCursor function undoes the effect of a previous
XDefineDeviceCursor 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.
XDefineDeviceCursor and XUndefineDeviceCursor are identical to
XDefineCursor and XUndefineCursor but specify the device explicitly.
XUndefineDevicePointer can generate a BadDevice and a BadWindow error.
DIAGNOSIS
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
AUTHOR
Peter Hutterer
Specification and implementation.
February 14, 2008 XDEFINEDEVICECURSOR,(3)