hpux man page for xttranslatc

XtTranslateKeycode()													      XtTranslateKeycode()

Name
  XtTranslateKeycode - invoke the currently registered keycode-to-keysym translator.

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

Inputs
  display   Specifies the display that the keycode is from.

  keycode   Specifies the keycode to translate.

  modifiers Specifies the modifiers to be applied to the keycode.

Outputs
  modifiers_return
	    Returns a mask that indicates the modifiers actually used to generate the keysym.

  keysym_return
	    Returns the resulting keysym.

Description
  XtTranslateKeycode()	converts  a  keycode  plus modifiers into a keysym.  It invokes the currently registered keycode-to-keysym translator
  (XtTranslateKey() by default) and passes its arguments directly to that converter.

  See XtTranslateKey() for a description of the default translator.  See XtKeyProc(2) for more details on  the	operation  of  a  keycode-to-
  keysym translator procedure.

Usage
  The  Translation  Manager  invokes the currently registered key translator procedure to convert incoming keycodes to keysyms.  Only clients
  that need to work with non-standard keysyms should need to register alternate key translator procedures.

  The default key translator, XtTranslateKey(), can also be invoked directly.  A new translator can be registered by calling XtSetKeyTransla-
  tor().

Structures
  The KeyCode and KeySym types are defined as follows:

     typedef unsigned char KeyCode;
     typedef XID KeySym;

  The Modifiers type and its legal values are defined as follows:

     typedef unsigned int Modifiers;
     #define ShiftMask	      (1<<0)
     #define LockMask	      (1<<1)
     #define ControlMask      (1<<2)
     #define Mod1Mask	      (1<<3)
     #define Mod2Mask	      (1<<4)
     #define Mod3Mask	      (1<<5)
     #define Mod4Mask	      (1<<6)
     #define Mod5Mask	      (1<<7)

See Also
  XtRegisterCaseConverter(1), XtSetKeyTranslator(1), XtTranslateKey(1),
  XtKeyProc(2).

Xt - Keyboard Handling													      XtTranslateKeycode()