XFreeCursor.3X11.z(3X11)



     X Version 11 (Release 5)                     XRecolorCursor(3X11)



     NAME
          XRecolorCursor, XFreeCursor, XQueryBestCursor - manipulate
          cursors

     SYNTAX
          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;

     ARGUMENTS
          background_color
                    Specifies the RGB values for the background of the
                    source.

          cursor    Specifies the cursor.

          d         Specifies the drawable, which indicates the
                    screen.

          display   Specifies the connection to the X server.

          foreground_color
                    Specifies the RGB values for the foreground of the
                    source.

          width
          height    Specify the width and heightof the cursor that you
                    want the size information for.

          width_return
          height_return
                    Return the best width and height that is closest
                    to the specified width and height.

     DESCRIPTION
          The XRecolorCursor function changes the color of the
          specified cursor, and if the cursor is being displayed on a
          screen, the change is visible immediately.  Note that the
          pixel members of the XColor structures are ignored, only the



     Licensed material--property of copyright holder(s)         Page 1



                         X Version 11 (Release 5) XRecolorCursor(3X11)



          RGB values are used.

          XRecolorCursor can generate a BadCursor error.

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

          XFreeCursor can generate a BadCursor error.

          Some displays allow larger cursors than other displays.  The
          XQueryBestCursor function provides a way to find out what
          size cursors are actually possible on the display.  It
          returns the largest size that can be displayed.
          Applications should be prepared to use smaller cursors on
          displays that cannot support large ones.

          XQueryBestCursor can generate a BadDrawable error.

     DIAGNOSTICS
          BadCursor A value for a Cursor argument does not name a
                    defined Cursor.

          BadDrawable
                    A value for a Drawable argument does not name a
                    defined Window or Pixmap.

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























     Licensed material--property of copyright holder(s)         Page 2

Museum