XIDefineCursor.man revision 37eb1ca1 
 t
 Title: xidefinecursor
 Author: [FIXME: author] [see http://docbook.sf.net/el/author]
 Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
 Date: 10/07/2010
 Manual: [FIXME: manual]
 Source: [FIXME: source]
 Language: English

 "XIDEFINECURSOR" "libmansuffix" "10/07/2010" "[FIXME: source]" "[FIXME: manual]"
 -----------------------------------------------------------------
 * set default formatting
 -----------------------------------------------------------------
 disable hyphenation
 disable justification (adjust text to left margin only)
 -----------------------------------------------------------------
 * MAIN CONTENT STARTS HERE *
 -----------------------------------------------------------------
 "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




.\}