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

NAME

XtRegisterCaseConverter − register a case converter.

SYNOPSIS

void XtRegisterCaseConverter(display, proc, start, stop)
    Display ∗display;
    XtCaseProc proc;
    KeySym start;
    KeySym stop;

Inputs

displaySpecifies the display from which the key events are to come.

procSpecifies the XtCaseProc that is to do the conversions.

startSpecifies the first keysym for which this converter is valid.

stopSpecifies the last keysym for which this converter is valid.

DESCRIPTION

XtRegisterCaseConverter() registers proc with the Intrinsics as a procedure to be called in order to determine the correct uppercase and lowercase versions of any keysyms between start and stop inclusive. The registered converter overrides any previous converters registered in that range.

See XtCaseProc(2) for a description of how to write a case converter procedure.

USAGE

The Translation Manager uses case converters as part of its keycode-to-keysym translation process. The default converter understands case conversion for all keysyms defined in the X11 protocol. You will probably never need to register a case converter unless you are working with non-standard keysyms.

The only way to remove a converter is to register a new one, perhaps an "identity" converter which performs no conversion at all.

The registered case converters are invoked by the translation manager, and can also be explicitly called with the function XtConvertCase().

STRUCTURES

typedef XID KeySym;