Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
XRecolorCursor(3)		 XLIB FUNCTIONS 	       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 height of 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 immedi-
     ately.   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  re-
     ferred to again.

     XFreeCursor can generate a BadCursor error.

     Some displays allow larger cursors than other displays.  The XQueryBestCur-
     sor function provides a way to find out what size cursors are actually pos-
     sible  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(3), XCreateFontCursor(3), XDefineCursor(3)
     Xlib - C Language X Interface

X Version 11			  libX11 1.8.13 	       XRecolorCursor(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XRecolorCursor&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help