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