hpux man page for xtsetkeytranslator

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()