XDefineCursor(3X11) RISC/os Reference Manual  XDefineCursor(3X11)



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 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 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
               defined Window.

SEE ALSO
     XCreateFontCursor(3X11), XRecolorCursor(3X11)
     Xlib - C Language X Interface







                         Printed 1/24/91         Release 4 Page 1