XtSetKeyTranslator() XtSetKeyTranslator()
Name
XtSetKeyTranslator - register a key translator.
Synopsis
void XtSetKeyTranslator(display, proc)
Display *display;
XtKeyProc proc;
Inputs
display Specifies the display from which to translate the events.
proc Specifies the procedure that is to perform key translations.
Description
XtSetKeyTranslator() registers the specified procedure as the current key translator. The default translator is XtTranslateKey(), an
XtKeyProc that uses the Shift, Lock, and group modifiers with the interpretations defined by the X11 protocol. XtTranslateKey() is pro-
vided so that new translators can call it to get default keycode-to-keysym translations and so that the default translator can be rein-
stalled.
See XtKeyProc(2) for an explanation of the responsibilities of a key translator procedure.
Usage
The key translator procedure is called by the Translation Manager to convert incoming keycodes and modifier bits to keysyms. The only rea-
son you would have to write and install your own key translator procedure is if you were working with non-standard keysyms.
The only way to remove a translator is to register a new one. For example, the default key translator (XtTranslateKey()) can be explicitly
reinstalled.
See Also
XtConvertCase(1), XtGetKeysymTable(1), XtKeysymToKeycodeList(1), XtRegisterCaseConverter(1), XtTranslateKeycode(1), XtTranslateKey(1),
XtKeyProc(2).
Xt - Keyboard Handling XtSetKeyTranslator()
