XmTranslateKey(3X)

NAME
     XmTranslateKey --The default keycode-to-keysym translator

SYNOPSIS
     #include <Xm/Xm.h>

     void XmTranslateKey (display, keycode, modifiers, modifiers_return, keysym_return)
          Display   *display;
          KeyCode   keycode;
          Modifiers modifiers;
          Modifiers *modifiers_return;
          KeySym    *keysym_return;


VERSION
     This page documents version 1.2 of the Motif library.

DESCRIPTION
     XmTranslateKey is the default XtKeyProc translation procedure for Motif ap-
     plications.   The  function  takes  a keycode and modifiers and returns the
     corresponding keysym.

     XmTranslateKey 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.


     display     Specifies the display that the keycode is from

     keycode     Specifies the keycode to translate

     modifiers   Specifies the modifier keys to be applied to the keycode

     modifiers_return
                 Specifies a mask of the modifier keys actually used to generate
                 the  keysym  (an AND of modifiers and any default modifiers ap-
                 plied by the currently registered translator)

     keysym_return
                 Specifies a pointer to the resulting keysym


RELATED INFORMATION
     VirtualBindings(3X).

                                                              XmTranslateKey(3X)