XFreeCursor


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 spec- ified cursor, and if the cursor is being displayed on a screen, the change is visible immediately. The pixel mem- bers 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 resource ID and the specified cursor. The cur- sor 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. Appli- cations should be prepared to use smaller cursors on dis- plays 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(3), XCreateFontCursor(3), XDefineCu- sor(3) Xlib - C Language X Interface

Man(1) output converted with man2html