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