XDefineCursor(XS) X Version 11 (Release 5) 6 January 1993  XDefineCursor(XS)


 Name

    XDefineCursor - 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 XUndefineCursor.

    XDefineCursor can generate ``BadCursor'' and ``BadWindow'' errors.

    The XUndefineCursor function undoes the effect of a previous XDefineCur-
    sor 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 Cur-
                   sor.

    ``BadWindow''  A value for a Window argument does not name a defined Win-
                   dow.

 See also

    XCreateFontCursor(XS), XRecolorCursor(XS)
    Xlib - C Language X Interface