TrnsKeycode(3X) — DeltaWindows 1.3.3 Release 4 Version 4.3

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

displaySpecifies the display that the keycode is from.

keycodeSpecifies the keycode to translate.

modifiersSpecifies the modifiers to be applied to the keycode.

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

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)