Name

XtGetKeysymTable — return a pointer to the keysym-to-keycode mapping table for a particular display. 

Synopsis

KeySym ∗XtGetKeysymTable(display, min_keycode_return, keysyms_per_keycode_return)

      Display ∗display;
      KeyCode ∗min_keycode_return;
      int ∗keysyms_per_keycode_return;

Arguments

displaySpecifies the display whose table is required. 

min_keycode_return
Returns the minimum keycode valid for the display.

keysyms_per_keycode_return
Returns the number of keysyms stored for each keycode.

Description

The Intrinsics maintain tables internally to map keycodes to keysyms for each open display.  Translator procedure and other clients may share a single copy of this table to perform the same mapping. 

XtGetKeysymTable returns a pointer to the Intrinsics’ copy of the server’s keycode-to-keysym table.  This table must not be modified.  The number of keysyms associated with each keycode is indicated by the argument keysyms_per_keycode_return.  The keysyms are located in the mapping table.  For a given keycode test_keycode, the table would have indices, starting at index:

(test_keycode - min_keycode) ∗ keysyms_per_keycode_return

Any entries that have no keysyms associated with them contain the value NoSymbol.  Clients should not cache the keysym table but should call XtGetKeysymTable each time the value is needed, as the table may change prior to dispatching each event. 

See Also

XtConvertCase(1), XtKeysymToKeycodeList(1), XtRegisterCaseConverter(1), XtSetKeyTranslator(1), XtTranslateKeycode(1).