XDefineCursor (3)
Leading comments
Copyright \(co 1985, 1986, 1987, 1988, 1989, 1990, 1991, 1994, 1996 X Consortium Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the foll...
NAME
XDefineCursor, XUndefineCursor - define cursorsSYNTAX
- int XDefineCursor(Display *display, Window w, Cursor cursor);
- int XUndefineCursor(Display *display, Window w);
ARGUMENTS
- cursor
- Specifies the cursor that is to be displayed or None.
- display
- Specifies the connection to the X server.
- w
- Specifies the window.
DESCRIPTION
If a cursor is set, it will be used when the pointer is in the window. If the cursor is None, it is equivalent to XUndefineCursor.XDefineCursor can generate BadCursor and BadWindow errors.
The XUndefineCursor function undoes the effect of a previous XDefineCursor for this window. When the pointer is in the window, the parent's cursor will now be used. On the root window, the default cursor is restored.
XUndefineCursor can generate a BadWindow error.
DIAGNOSTICS
- BadAlloc
- The server failed to allocate the requested resource or server memory.
- BadCursor
- A value for a Cursor argument does not name a defined Cursor.
- BadWindow
- A value for a Window argument does not name a defined Window.
SEE ALSO
XCreateFontCursor(3), XRecolorCursor(3)Xlib - C Language X Interface