NAME
XRecolorCursor, XFreeCursor, XQueryBestCursor - manipulate cursors
SYNTAX
int XRecolorCursor(Display *_d_i_s_p_l_a_y, Cursor _c_u_r_s_o_r, XColor
*_f_o_r_e_g_r_o_u_n_d___c_o_l_o_r, XColor *_b_a_c_k_g_r_o_u_n_d___c_o_l_o_r);
int XFreeCursor(Display *_d_i_s_p_l_a_y, Cursor _c_u_r_s_o_r);
Status XQueryBestCursor(Display *_d_i_s_p_l_a_y, Drawable _d,
unsigned int _w_i_d_t_h, unsigned int _h_e_i_g_h_t, unsigned int
*_w_i_d_t_h___r_e_t_u_r_n, unsigned int *_h_e_i_g_h_t___r_e_t_u_r_n);
ARGUMENTS
-
_b_a_c_k_g_r_o_u_n_d___c_o_l_o_r
Specifies the RGB values for the background of the source.
-
-
_c_u_r_s_o_r
Specifies the cursor.
-
-
_d
Specifies the drawable, which indicates the screen.
-
-
_d_i_s_p_l_a_y
Specifies the connection to the X server.
-
-
_f_o_r_e_g_r_o_u_n_d___c_o_l_o_r
Specifies the RGB values for the foreground of the source.
-
-
_w_i_d_t_h
-
-
_h_e_i_g_h_t
Specify the width and heightof the cursor that you want the size information for.
-
-
_w_i_d_t_h___r_e_t_u_r_n
-
-
_h_e_i_g_h_t___r_e_t_u_r_n
Return the best width and height that is closest to the specified width
-
and height.
DESCRIPTION
The
_X_R_e_c_o_l_o_r_C_u_r_s_o_r
function changes the color of the specified cursor, and
if the cursor is being displayed on a screen,
the change is visible immediately.
The pixel members of the
_X_C_o_l_o_r
structures are ignored; only the RGB values are used.
_X_R_e_c_o_l_o_r_C_u_r_s_o_r
can generate a
_B_a_d_C_u_r_s_o_r
error.
The
_X_F_r_e_e_C_u_r_s_o_r
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.
_X_F_r_e_e_C_u_r_s_o_r
can generate a
_B_a_d_C_u_r_s_o_r
error.
Some displays allow larger cursors than other displays.
The
_X_Q_u_e_r_y_B_e_s_t_C_u_r_s_o_r
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.
Applications should be prepared to use smaller cursors on displays that
cannot support large ones.
_X_Q_u_e_r_y_B_e_s_t_C_u_r_s_o_r
can generate a
_B_a_d_D_r_a_w_a_b_l_e
error.
DIAGNOSTICS
-
_B_a_d_C_u_r_s_o_r
-
A value for a Cursor argument does not name a defined Cursor.
-
_B_a_d_D_r_a_w_a_b_l_e
-
A value for a Drawable argument does not name a defined Window or Pixmap.
SEE ALSO
XCreateColormap(3X11),
XCreateFontCursor(3X11),
XDefineCusor(3X11)
_X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e