XRecolorCursor(3X11) XLIB FUNCTIONS 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 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.
X Version 11 Release 6.4 1
XRecolorCursor(3X11) XLIB FUNCTIONS XRecolorCursor(3X11)
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 ALSOXCreateColormap(3X11), XCreateFontCursor(3X11), XDefineCu-
sor(3X11)
Xlib - C Language X Interface
X Version 11 Release 6.4 2