XIDefineCursor(3)

Usage

int XIDefineCursor( Display *display,

Cursor cursor);

int XIUndefineCursor( Display *display,

Window win);

cursor

Specifies the cursor that is to be displayed or None.

deviceid

display

win

Overview

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.

History

Debian 13 (Trixie): the text shown here
Debian 12 (Bookworm)
Debian 11 (Bullseye)
Debian 10 (Buster) to Debian 8 (Jessie)
Debian 7 (Wheezy)
Debian 6.0 (Squeeze)