Name

XtKeysymToKeycodeList — return the list of keycodes that map to a particular keysym in the keyboard mapping table maintained by the Intrinsics. 

Synopsis

void XtKeysymToKeycodeList(display, keysym, keycodes_return, keycount_return)

      Display ∗display;
      KeySym keysym;
      KeyCode ∗∗keycodes_return;
      Cardinal ∗keycount_return;

Arguments

displaySpecifies the display whose table is required. 

keysymSpecifies the keysym for which to search. 

keycodes_return
Returns a list of keycodes that have keysyms associated with them or NULL if keycount_return is 0. 

keycount_return
Returns the number of keycodes in the keycodes list.

Description

The XtKeysymToKeycodeList procedure returns all the keycodes that have the requested keysym in their entry for the keyboard mapping table associated with display.  For each entry in the table, the first four keysyms (groups 1 and 2) are interpreted as specified by the X Protocol specification.  If no keycodes map to the specified keysym, keycount_return is 0 and ∗keycodes_return is NULL. 

The caller should free the storage pointed to by keycodes_return using XtFree when it is no longer useful.  If the caller needs to examine the keycode-to-keysym table for a particular keycode, it should call XtGetKeysymTable. 

See Also

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