Manual pages › X Window and screen libraries (3X)

XRecCur(3X)

manipulate cursors

From the original Amiga UNIX 2.1 manual. Some things it mentions may not be in this release.

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 XWIN server.

foreground_color

Specifies the RGB values for the foreground of the source.

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

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 speci-
     fied cursor, and if the cursor is being displayed on a
     screen, the change is visible immediately.

XWIN 3.0               Last change: 9/1/88                 .ie t

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.  Applica-
tions 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.