


XmTranslateKey(3X)					   XmTranslateKey(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmTTrraannssllaatteeKKeeyy - The default keycode-to-keysym translator

SYNOPSIS


  ##iinncclluuddee <<XXmm//XXmm..hh>>
  vvooiidd XXmmTTrraannssllaatteeKKeeyy ((_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))
       DDiissppllaayy	 **_d_i_s_p_l_a_y;;
       KKeeyyCCooddee	 _k_e_y_c_o_d_e;;
       MMooddiiffiieerrss _m_o_d_i_f_i_e_r_s;;
       MMooddiiffiieerrss **_m_o_d_i_f_i_e_r_s__r_e_t_u_r_n;;
       KKeeyySSyymm	 **_k_e_y_s_y_m__r_e_t_u_r_n;;

DESCRIPTION
  XXmmTTrraannssllaatteeKKeeyy is the	default	XXttKKeeyyPPrroocc translation procedure	for Motif
  applications.	 The function takes a keycode and modifiers and	returns	the
  corresponding	keysym.

  XXmmTTrraannssllaatteeKKeeyy serves	two main purposes: new translators with	expanded
  functionality	can call it to get the default Motif keycode-to-keysym trans-
  lation in addition to	whatever they add, and so that the default translator
  can be reinstalled.  This function enables keysyms defined by	the Motif
  virtual bindings to be used when an application requires its own XtKeyProc
  to be	installed.

  _d_i_s_p_l_a_y     Specifies	the display that the keycode is	from

  _k_e_y_c_o_d_e     Specifies	the keycode to translate

  _m_o_d_i_f_i_e_r_s   Specifies	the modifier keys to be	applied	to the keycode

  _m_o_d_i_f_i_e_r_s__r_e_t_u_r_n
	      Specifies	a mask of the modifier keys actually used to generate
	      the keysym (an AND of _m_o_d_i_f_i_e_r_s and any default modifiers
	      applied by the currently registered translator)

  _k_e_y_s_y_m__r_e_t_u_r_n
	      Specifies	a pointer to the resulting keysym

RELATED	INFORMATION
  VViirrttuuaallBBiinnddiinnggss((33XX)).















