XmTranslateKey(X3mot)

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;

Description

XmTranslateKey is the default XtKeyProc translation procedure for Motif applications. 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 translation 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 applied by the currently registered translator)
keysym_return: Specifies a pointer to the resulting keysym

References

VirtualBindings(X3mot)