NAME

XGetDeviceModifierMapping, XSetDeviceModifierMapping - query or change device modifier mappings

SYNTAX

iinntt XXSSeettDDeevviicceeMMooddiiffiieerrMMaappppiinngg((DDiissppllaayy **_d_i_s_p_l_a_y,, XXDDeevviiccee **_d_e_v_i_c_e,, XXMMooddiiffiieerrKKeeyymmaapp **_m_o_d_m_a_p));; XXMMooddiiffiieerrKKeeyymmaapp **XXGGeettDDeevviicceeMMooddiiffiieerrMMaappppiinngg((DDiissppllaayy **_d_i_s_p_l_a_y,, XXDDeevviiccee **_d_e_v_i_c_e));; _<_h_3 _i_d_=_"_A_R_G_U_M_E_N_T_S_"_> _A_R_G_U_M_E_N_T_S _<_/_h_3_> _<_d_l _c_o_m_p_a_c_t_> _<_d_t_> _<_i_>_d_i_s_p_l_a_y_<_/_i_> _<_d_d_> _S_p_e_c_i_f_i_e_s _t_h_e _c_o_n_n_e_c_t_i_o_n _t_o _t_h_e _X _s_e_r_v_e_r_. _<_d_t_> _<_i_>_d_e_v_i_c_e_<_/_i_> _<_d_d_> _S_p_e_c_i_f_i_e_s _t_h_e _d_e_v_i_c_e _w_h_o_s_e _m_o_d_i_f_i_e_r _m_a_p_p_i_n_g _i_s _t_o _b_e _q_u_e_r_i_e_d _o_r _m_o_d_i_f_i_e_d_. _<_d_t_> _<_i_>_m_o_d_m_a_p_<_/_i_> _<_d_d_> _S_p_e_c_i_f_i_e_s _a _p_o_i_n_t_e_r _t_o _t_h_e _X_M_o_d_i_f_i_e_r_K_e_y_m_a_p _s_t_r_u_c_t_u_r_e_. _<_/_d_l_> _<_h_3 _i_d_=_"_D_E_S_C_R_I_P_T_I_O_N_"_> _D_E_S_C_R_I_P_T_I_O_N _<_/_h_3_> _T_h_e _X_S_e_t_D_e_v_i_c_e_M_o_d_i_f_i_e_r_M_a_p_p_i_n_g _r_e_q_u_e_s_t _s_p_e_c_i_f_i_e_s _t_h_e _K_e_y_C_o_d_e_s _o_f _t_h_e _k_e_y_s _(_i_f _a_n_y_) _t_h_a_t _a_r_e _t_o _b_e _u_s_e_d _a_s _m_o_d_i_f_i_e_r_s _f_o_r _t_h_e _s_p_e_c_i_f_i_e_d _d_e_v_i_c_e_. _I_f _i_t _s_u_c_c_e_e_d_s_, _t_h_e _X _s_e_r_v_e_r _g_e_n_e_r_a_t_e_s _a _D_e_v_i_c_e_M_a_p_p_i_n_g_N_o_t_i_f_y _e_v_e_n_t_, _a_n_d _X_S_e_t_D_e_v_i_c_e_M_o_d_i_f_i_e_r_M_a_p_p_i_n_g _r_e_t_u_r_n_s _M_a_p_p_i_n_g_S_u_c_c_e_s_s_. _X _p_e_r_m_i_t_s _a_t _m_o_s_t _e_i_g_h_t _m_o_d_i_f_i_e_r _k_e_y_s_. _I_f _m_o_r_e _t_h_a_n _e_i_g_h_t _a_r_e _s_p_e_c_i_f_i_e_d _i_n _t_h_e _X_M_o_d_i_f_i_e_r_K_e_y_m_a_p _s_t_r_u_c_t_u_r_e_, _a _B_a_d_L_e_n_g_t_h _e_r_r_o_r _r_e_s_u_l_t_s_. _<_p_> _T_h_e _m_o_d_i_f_i_e_r_m_a_p _m_e_m_b_e_r _o_f _t_h_e _X_M_o_d_i_f_i_e_r_K_e_y_m_a_p _s_t_r_u_c_t_u_r_e _c_o_n_t_a_i_n_s _e_i_g_h_t _s_e_t_s _o_f _m_a_x___k_e_y_p_e_r_m_o_d _K_e_y_C_o_d_e_s_, _o_n_e _f_o_r _e_a_c_h _m_o_d_i_f_i_e_r _i_n _t_h_e _o_r_d_e_r _S_h_i_f_t_, _L_o_c_k_, _C_o_n_t_r_o_l_, _M_o_d_1_, _M_o_d_2_, _M_o_d_3_, _M_o_d_4_, _a_n_d _M_o_d_5_. _O_n_l_y _n_o_n_z_e_r_o _K_e_y_C_o_d_e_s _h_a_v_e _m_e_a_n_i_n_g _i_n _e_a_c_h _s_e_t_, _a_n_d _z_e_r_o _K_e_y_C_o_d_e_s _a_r_e _i_g_n_o_r_e_d_. _I_n _a_d_d_i_t_i_o_n_, _a_l_l _o_f _t_h_e _n_o_n_z_e_r_o _K_e_y_C_o_d_e_s _m_u_s_t _b_e _i_n _t_h_e _r_a_n_g_e _s_p_e_c_i_f_i_e_d _b_y _m_i_n___k_e_y_c_o_d_e _a_n_d _m_a_x___k_e_y_c_o_d_e _a_s _r_e_t_u_r_n_e_d _b_y _X_L_i_s_t_I_n_p_u_t_D_e_v_i_c_e_s_, _o_r _a _B_a_d_V_a_l_u_e _e_r_r_o_r _r_e_s_u_l_t_s_. _N_o _K_e_y_C_o_d_e _m_a_y _a_p_p_e_a_r _t_w_i_c_e _i_n _t_h_e _e_n_t_i_r_e _m_a_p_, _o_r _a _B_a_d_V_a_l_u_e _e_r_r_o_r _r_e_s_u_l_t_s_. _<_p_> _A_n _X _s_e_r_v_e_r _c_a_n _i_m_p_o_s_e _r_e_s_t_r_i_c_t_i_o_n_s _o_n _h_o_w _m_o_d_i_f_i_e_r_s _c_a_n _b_e _c_h_a_n_g_e_d_, _f_o_r _e_x_a_m_p_l_e_, _i_f _c_e_r_t_a_i_n _k_e_y_s _d_o _n_o_t _g_e_n_e_r_a_t_e _u_p _t_r_a_n_s_i_t_i_o_n_s _i_n _h_a_r_d_w_a_r_e_, _i_f _a_u_t_o_-_r_e_p_e_a_t _c_a_n_n_o_t _b_e _d_i_s_a_b_l_e_d _o_n _c_e_r_t_a_i_n _k_e_y_s_, _o_r _i_f _m_u_l_t_i_p_l_e _m_o_d_i_f_i_e_r _k_e_y_s _a_r_e _n_o_t _s_u_p_p_o_r_t_e_d_. _I_f _s_o_m_e _s_u_c_h _r_e_s_t_r_i_c_t_i_o_n _i_s _v_i_o_l_a_t_e_d_, _t_h_e _s_t_a_t_u_s _r_e_p_l_y _i_s _M_a_p_p_i_n_g_F_a_i_l_e_d_, _a_n_d _n_o_n_e _o_f _t_h_e _m_o_d_i_f_i_e_r_s _a_r_e _c_h_a_n_g_e_d_. _I_f _t_h_e _n_e_w _K_e_y_C_o_d_e_s _s_p_e_c_i_f_i_e_d _f_o_r _a _m_o_d_i_f_i_e_r _d_i_f_f_e_r _f_r_o_m _t_h_o_s_e _c_u_r_r_e_n_t_l_y _d_e_f_i_n_e_d _a_n_d _a_n_y _(_c_u_r_r_e_n_t _o_r _n_e_w_) _k_e_y_s _f_o_r _t_h_a_t _m_o_d_i_f_i_e_r _a_r_e _i_n _t_h_e _l_o_g_i_c_a_l_l_y _d_o_w_n _s_t_a_t_e_, _X_S_e_t_D_e_v_i_c_e_M_o_d_i_f_i_e_r_M_a_p_p_i_n_g _r_e_t_u_r_n_s _M_a_p_p_i_n_g_B_u_s_y_, _a_n_d _n_o_n_e _o_f _t_h_e _m_o_d_i_f_i_e_r_s _i_s _c_h_a_n_g_e_d_. _<_p_> _X_S_e_t_D_e_v_i_c_e_M_o_d_i_f_i_e_r_M_a_p_p_i_n_g _c_a_n _g_e_n_e_r_a_t_e _B_a_d_L_e_n_g_t_h_P_, _B_a_d_D_e_v_i_c_e_, _B_a_d_M_a_t_c_h_, _B_a_d_A_l_l_o_c_, _a_n_d _B_a_d_V_a_l_u_e _e_r_r_o_r_s_. _<_p_> _T_h_e _X_G_e_t_D_e_v_i_c_e_M_o_d_i_f_i_e_r_M_a_p_p_i_n_g _r_e_q_u_e_s_t _r_e_t_u_r_n_s _a _p_o_i_n_t_e_r _t_o _a _n_e_w_l_y _c_r_e_a_t_e_d _X_M_o_d_i_f_i_e_r_K_e_y_m_a_p _s_t_r_u_c_t_u_r_e _t_h_a_t _c_o_n_t_a_i_n_s _t_h_e _k_e_y_s _b_e_i_n_g _u_s_e_d _a_s _m_o_d_i_f_i_e_r_s_. _T_h_e _s_t_r_u_c_t_u_r_e _s_h_o_u_l_d _b_e _f_r_e_e_d _a_f_t_e_r _u_s_e _b_y _c_a_l_l_i_n_g _X_F_r_e_e_M_o_d_i_f_i_e_r_M_a_p_p_i_n_g _. _I_f _o_n_l_y _z_e_r_o _v_a_l_u_e_s _a_p_p_e_a_r _i_n _t_h_e _s_e_t _f_o_r _a_n_y _m_o_d_i_f_i_e_r_, _t_h_a_t _m_o_d_i_f_i_e_r _i_s _d_i_s_a_b_l_e_d_. _<_p_> _X_G_e_t_D_e_v_i_c_e_M_o_d_i_f_i_e_r_M_a_p_p_i_n_g _c_a_n _g_e_n_e_r_a_t_e _B_a_d_D_e_v_i_c_e _a_n_d _B_a_d_M_a_t_c_h _e_r_r_o_r_s_. _<_h_3 _i_d_=_"_S_T_R_U_C_T_U_R_E_S_"_> _S_T_R_U_C_T_U_R_E_S _<_/_h_3_> _T_h_e _X_M_o_d_i_f_i_e_r_K_e_y_m_a_p _s_t_r_u_c_t_u_r_e _c_o_n_t_a_i_n_s_: _<_p_> _<_b_r_> _<_p_r_e_> _t_y_p_e_d_e_f _s_t_r_u_c_t _{ _i_n_t _m_a_x___k_e_y_p_e_r_m_o_d_; _K_e_y_C_o_d_e _*_m_o_d_i_f_i_e_r_m_a_p_; _} _X_M_o_d_i_f_i_e_r_K_e_y_m_a_p_; _<_/_p_r_e_> _<_p_> _<_h_3 _i_d_=_"_D_I_A_G_N_O_S_T_I_C_S_"_> _D_I_A_G_N_O_S_T_I_C_S _<_/_h_3_> _<_d_l _c_o_m_p_a_c_t_> _<_d_t_> _B_a_d_L_e_n_g_t_h _<_d_d_> _M_o_r_e _t_h_a_n _e_i_g_h_t _k_e_y_s _w_e_r_e _s_p_e_c_i_f_i_e_d _i_n _t_h_e _X_M_o_d_i_f_i_e_r_K_e_y_m_a_p _s_t_r_u_c_t_u_r_e_. _<_d_t_> _B_a_d_A_l_l_o_c _<_d_d_> _T_h_e _s_e_r_v_e_r _f_a_i_l_e_d _t_o _a_l_l_o_c_a_t_e _t_h_e _r_e_q_u_e_s_t_e_d _r_e_s_o_u_r_c_e _o_r _s_e_r_v_e_r _m_e_m_o_r_y_. _<_d_t_> _B_a_d_D_e_v_i_c_e _<_d_d_> _A_n _i_n_v_a_l_i_d _d_e_v_i_c_e _w_a_s _s_p_e_c_i_f_i_e_d_. _T_h_e _s_p_e_c_i_f_i_e_d _d_e_v_i_c_e _d_o_e_s _n_o_t _e_x_i_s_t _o_r _h_a_s _n_o_t _b_e_e_n _o_p_e_n_e_d _b_y _t_h_i_s _c_l_i_e_n_t _v_i_a _X_O_p_e_n_I_n_p_u_t_D_e_v_i_c_e_. _T_h_i_s _e_r_r_o_r _m_a_y _a_l_s_o _o_c_c_u_r _i_f _t_h_e _s_p_e_c_i_f_i_e_d _d_e_v_i_c_e _i_s _t_h_e _X _k_e_y_b_o_a_r_d _o_r _X _p_o_i_n_t_e_r _d_e_v_i_c_e_. _<_d_t_> _B_a_d_M_a_t_c_h _<_d_d_> _T_h_i_s _e_r_r_o_r _m_a_y _o_c_c_u_r _i_f _a_n _X_G_e_t_D_e_v_i_c_e_M_o_d_i_f_i_e_r_M_a_p_p_i_n_g _o_r _X_C_h_a_n_g_e_D_e_v_i_c_e_M_o_d_i_f_i_e_r_M_a_p_p_i_n_g _r_e_q_u_e_s_t _w_a_s _m_a_d_e _s_p_e_c_i_f_y_i_n_g _a _d_e_v_i_c_e _t_h_a_t _h_a_s _n_o _k_e_y_s_. _<_d_t_> _B_a_d_V_a_l_u_e _<_d_d_> _S_o_m_e _n_u_m_e_r_i_c _v_a_l_u_e _f_a_l_l_s _o_u_t_s_i_d_e _t_h_e _r_a_n_g_e _o_f _v_a_l_u_e_s _a_c_c_e_p_t_e_d _b_y _t_h_e _r_e_q_u_e_s_t_. _U_n_l_e_s_s _a _s_p_e_c_i_f_i_c _r_a_n_g_e _i_s _s_p_e_c_i_f_i_e_d _f_o_r _a_n _a_r_g_u_m_e_n_t_, _t_h_e _f_u_l_l _r_a_n_g_e _d_e_f_i_n_e_d _b_y _t_h_e _a_r_g_u_m_e_n_t_'_s _t_y_p_e _i_s _a_c_c_e_p_t_e_d_. _A_n_y _a_r_g_u_m_e_n_t _d_e_f_i_n_e_d _a_s _a _s_e_t _o_f _a_l_t_e_r_n_a_t_i_v_e_s _c_a_n _g_e_n_e_r_a_t_e _t_h_i_s _e_r_r_o_r_. _<_/_d_l_> _<_h_3 _i_d_=_"_S_E_E _A_L_S_O_"_> _S_E_E _A_L_S_O _<_/_h_3_> _X_S_e_t_D_e_v_i_c_e_K_e_y_M_a_p_p_i_n_g_(_3_X_1_1_) _<_b_r_> _X_S_e_t_D_e_v_i_c_e_B_u_t_t_o_n_M_a_p_p_i_n_g_(_3_X_1_1_) _<_b_r_> _P_r_o_g_r_a_m_m_i_n_g _W_i_t_h _X_l_i_b _<_/_b_o_d_y_>