NAME
XSetDeviceMode - change the mode of a device
SYNTAX
XSetDeviceMode(_d_i_s_p_l_a_y, _d_e_v_i_c_e, _m_o_d_e)
Display *_d_i_s_p_l_a_y;
XDevice *_d_e_v_i_c_e;
int ___m_o_d_e;
ARGUMENTS
-
display
-
Specifies the connection to the X server.
-
device
-
Specifies the device whose mode is to be changed.
-
mode
-
Specifies the mode.
You can pass
_A_b_s_o_l_u_t_e ,
or
_R_e_l_a_t_i_v_e.
DESCRIPTION
The
_X_S_e_t_D_e_v_i_c_e_M_o_d_e
request changes the mode of an input device that is capable of reporting
either absolute positional information or relative motion information.
Not all input devices are capable of reporting motion data, and not
all are capable of changing modes from _A_b_s_o_l_u_t_e to _R_e_l_a_t_i_v_e.
_X_S_e_t_D_e_v_i_c_e_M_o_d_e
can generate a _B_a_d_D_e_v_i_c_e or
_B_a_d_M_o_d_e
error.
DIAGNOSTICS
-
_B_a_d_D_e_v_i_c_e
-
An invalid device was specified. The specified device does not exist or has
not been opened by this client via _X_O_p_e_n_I_n_p_u_t_D_e_v_i_c_e. This error may
also occur if some other client has caused the specified device to become
the X keyboard or X pointer device via the _X_C_h_a_n_g_e_K_e_y_b_o_a_r_d_D_e_v_i_c_e or
_X_C_h_a_n_g_e_P_o_i_n_t_e_r_D_e_v_i_c_e requests.
-
_B_a_d_M_a_t_c_h
-
This error may occur if an _X_S_e_t_D_e_v_i_c_e_M_o_d_e request is made
specifying a device that has no valuators and reports no axes of motion.
-
_B_a_d_M_o_d_e
-
An invalid mode was specified. This error will also be returned if the
specified device is not capable of supporting the _X_S_e_t_D_e_v_i_c_e_M_o_d_e
request.
SEE ALSO
_P_r_o_g_r_a_m_m_i_n_g _w_i_t_h _X_l_i_b