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.
DescriptionXtTranslateKeycode() 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 alter‐
nate key translator procedures.
The default key translator, XtTranslateKey(), can also be invoked
directly. A new translator can be registered by calling XtSetKeyTrans‐
lator().
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 AlsoXtRegisterCaseConverter(1), XtSetKeyTranslator(1), XtTranslateKey(1),
XtKeyProc(2).
Xt - Keyboard Handling XtTranslateKeycode()
