NAME
XQueryBestCursor − get the closest supported cursor sizes.
Synopsis
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
displaySpecifies a connection to an X server; returned from XOpenDisplay().
dSpecifies a drawable that indicates which screen the cursor is to be used on. The best cursor may be different on different screens.
width
heightSpecify the preferred width and height, in pixels.
width_return
height_returnReturns the closest supported cursor dimensions, in pixels, on the display hardware.
Description
XQueryBestCursor() returns the closest cursor dimensions actually supported by the display hardware to the dimensions you specify. Call this function if you wish to use a cursor size other than 16 by 16. XQueryBestCursor() provides a way to find out what size cursors are actually possible on the display. Applications should be prepared to use smaller cursors on displays which cannot support large ones. XQueryBestCursor() returns nonzero if the call succeeded in getting a supported size (which may be the same or different from the specified size), or zero if the call failed.
Errors
BadDrawable
See Also
XCreateFontCursor(), XCreateGlyphCursor(), XCreatePixmapCursor(), XDefineCursor(), XFreeCursor(), XQueryBestSize(), XRecolorCursor(), XUndefineCursor().
Copyright O’Reilly & Assoc. —