Manual pages › X Window and screen libraries (3X)

XDefCur(3X)

define cursors

From the original Amiga UNIX 2.1 manual. Some things it mentions may not be in this release.

NAME

XDefineCursor, XUndefineCursor - define cursors

SYNTAX

XDefineCursor(display, w, cursor)
      Display *display;
      Window w;
      Cursor cursor;

XUndefineCursor(display, w)
      Display *display;
      Window w;

ARGUMENTS

cursor    Specifies the cursor that is to be displayed or
          None.

display   Specifies the connection to the XWIN 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 XUn-
defineCursor.

XDefineCursor can generate BadCursor and BadWindow errors.

The XUndefineCursor undoes the effect of a previous XDe-
fineCursor for this window.  When the pointer is in the win-
dow, the parent's cursor will now be used.  On the root win-
dow, 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