XRecolorCursor(3X)                             XRecolorCursor(3X)



NAME
     XRecolorCursor, XFreeCursor, XQueryBestCursor  -  manipulate
     pointers

SYNOPSIS
     XRecolorCursor (display, cursor, foreground-color,
     background-color)
     Display *display;
     Cursor cursor;
     XColor *foreground-color,*background-color;

     XFreeCursor (display, cursor)
     Display *display;
     Cursor cursor;

     Status XQueryBestCursor (display, d, width, height, width-
     return, height-return)
     Display *display;
     Drawable d;
     unsigned int width, height;
     unsigned int *width-return, *height-return;

DESCRIPTION
     The XRecolorCursor function changes the color of the speci-
     fied pointer. If the pointer is currently displayed on a
     screen, the change is immediately visible.

     The XFreeCursor function deletes the association between the
     pointer resource ID and the specified pointer.  The pointer
     storage is freed when no other resource references it. The
     specified pointer ID should not be referred to again.

     The XQueryBestCursor function returns the largest shape ac-
     tually supported by the display hardware.  Applications
     should be prepared to use smaller pointers on displays that
     cannot support large ones.

   Arguments
     These functions accept the following arguments:

     background-color
             Specifies the RGB values for the source background.

     cursor  Specifies the pointer.

     d       Specifies the drawable.

     display Specifies the connection to the X server.

     foreground-color
             Specifies the RGB values for the source foreground.




November, 1990                                                  1

XRecolorCursor(3X)                             XRecolorCursor(3X)



     width, height
             Specify the width and height of the pointer for
             which you want the size information.

     width-return, height-return
             Return the best width and height (that is, those ac-
             tual dimensions closest to the specified width and
             height).

ERRORS
     BadCursor
             A value for a Cursor argument does not name a de-
             fined pointer.

     BadDrawable
             A value for a Drawable argument does not name a de-
             fined window or pixel map.

     The XRecolorCursor and XFreeCursor functions can generate a
     BadCursor error.

     The XQueryBestCursor function can generate a
     BadDrawable error.

SEE ALSO
     XCreateColormap(3X), XCreateFontCursor(3X),
     XDefineCursor(3X)

     Xlib - C Language Interface



























2                                                  November, 1990