NAME

XtSetKeyTranslator, XtTranslateKeycode, XtRegisterCaseConverter, XtConvertCase - convert KeySym to KeyCodes

SYNTAX

void XtSetKeyTranslator(Display *_d_i_s_p_l_a_y, XtKeyProc _p_r_o_c); void XtTranslateKeycode(Display *_d_i_s_p_l_a_y, KeyCode _k_e_y_c_o_d_e, Modifiers _m_o_d_i_f_i_e_r_s, Modifiers *_m_o_d_i_f_i_e_r_s___r_e_t_u_r_n, KeySym *_k_e_y_s_y_m___r_e_t_u_r_n); void XtRegisterCaseConverter(Display *_d_i_s_p_l_a_y, XtCaseProc _p_r_o_c, KeySym _s_t_a_r_t, KeySym _s_t_o_p); void XtConvertCase(Display *_d_i_s_p_l_a_y, KeySym _k_e_y_s_y_m, KeySym *_l_o_w_e_r___r_e_t_u_r_n, KeySym *_u_p_p_e_r___r_e_t_u_r_n);

ARGUMENTS

_d_i_s_p_l_a_y Specifies the display.
_k_e_y_c_o_d_e Specifies the KeyCode to translate.
_k_e_y_s_y_m Specifies the KeySym to convert.
_k_e_y_s_y_m___r_e_t_u_r_n Returns the resulting KeySym.
_l_o_w_e_r___r_e_t_u_r_n Returns the lowercase equivalent of the KeySym.
_u_p_p_e_r___r_e_t_u_r_n Returns the uppercase equivalent of the KeySym.
_m_o_d_i_f_i_e_r_s Specifies the modifiers to the KeyCode.
_m_o_d_i_f_i_e_r_s___r_e_t_u_r_n Returns a mask that indicates the modifiers actually used
to generate the KeySym.
_p_r_o_c Specifies the procedure that is to perform key translations or conversions.
_s_t_a_r_t Specifies the first KeySym for which this converter is valid.
_s_t_o_p Specifies the last KeySym for which this converter is valid.

DESCRIPTION

The _X_t_S_e_t_K_e_y_T_r_a_n_s_l_a_t_o_r function sets the specified procedure as the current key translator. The default translator is _X_t_T_r_a_n_s_l_a_t_e_K_e_y, an _X_t_K_e_y_P_r_o_c that uses Shift and Lock modifiers with the interpretations defined by the core protocol. It is provided so that new translators can call it to get default KeyCode-to-KeySym translations and so that the default translator can be reinstalled.

The _X_t_T_r_a_n_s_l_a_t_e_K_e_y_c_o_d_e function passes the specified arguments directly to the currently registered KeyCode to KeySym translator.

The _X_t_R_e_g_i_s_t_e_r_C_a_s_e_C_o_n_v_e_r_t_e_r registers the specified case converter. The start and stop arguments provide the inclusive range of KeySyms for which this converter is to be called. The new converter overrides any previous converters for KeySyms in that range. No interface exists to remove converters; you need to register an identity converter. When a new converter is registered, the Intrinsics refreshes the keyboard state if necessary. The default converter understands case conversion for all KeySyms defined in the core protocol.

The _X_t_C_o_n_v_e_r_t_C_a_s_e function calls the appropriate converter and returns the results. A user-supplied _X_t_K_e_y_P_r_o_c may need to use this function.

SEE ALSO


_X _T_o_o_l_k_i_t _I_n_t_r_i_n_s_i_c_s _- _C _L_a_n_g_u_a_g_e _I_n_t_e_r_f_a_c_e
_X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e