XtTransKeyc(3x) — HPUX 9.05

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)

Museum