*** UNIX MANUAL PAGE BROWSER ***

XRecolorCursor(3) Library Functions Manual XRecolorCursor(3) NAME XRecolorCursor, XFreeCursor, XQueryBestCursor - manipulate cursors SYNTAX int XRecolorCursor(Display *display, Cursor cursor, XColor *fore- ground_color, XColor *background_color); int XFreeCursor(Display *display, Cursor cursor); Status XQueryBestCursor(Display *display, Drawable d, unsigned int width, unsigned int height, unsigned int *width_return, unsigned int *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 spec- ified 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. The pixel members of the XColor structures are ignored; only the RGB values are used. XRecolorCursor can generate a BadCursor error. The XFreeCursor function deletes the association between the cursor re- source 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 cur- sors 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 Win- dow or Pixmap. SEE ALSO XCreateColormap(3), XCreateFontCursor(3), XDefineCursor(3) Xlib - C Language X Interface XLIB FUNCTIONS X Version 11 XRecolorCursor(3)