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), XDefineCursor(3X11)
_X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e