


XtSetKeyTranslator(3Xt)				      XtSetKeyTranslator(3Xt)
X11R5									X11R5



NAME
  XtSetKeyTranslator, XtTranslateKeycode, XtRegisterCaseConverter, XtCon-
  vertCase - convert KeySym to KeyCodes

SYNTAX
  void XtSetKeyTranslator(_d_i_s_p_l_a_y, _p_r_o_c)
      Display *_d_i_s_p_l_a_y;
      XtKeyProc	_p_r_o_c;

  void XtTranslateKeycode(_d_i_s_p_l_a_y, _k_e_y_c_o_d_e, _m_o_d_i_f_i_e_r_s, _m_o_d_i_f_i_e_r_s__r_e_t_u_r_n,
  _k_e_y_s_y_m__r_e_t_u_r_n)
      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(_d_i_s_p_l_a_y,	_p_r_o_c, _s_t_a_r_t, _s_t_o_p)
      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(_d_i_s_p_l_a_y, _k_e_y_s_y_m, _l_o_w_e_r__r_e_t_u_r_n, _u_p_p_e_r__r_e_t_u_r_n)
      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 gen-
	    erate 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 con-
  verters; 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	delim off







































