hpux man page for xtkeysymtokeycodelist

XtKeysymToKeycodeList() 												   XtKeysymToKeycodeList()

Name
  XtKeysymToKeycodeList - return the list of keycodes that map to a particular keysym in the keyboard mapping table maintained by the Intrin-
  sics.

Synopsis
  void XtKeysymToKeycodeList(display, keysym, keycodes_return,
  keycount_return)
	   Display *display;
	   KeySym keysym;
	   KeyCode **keycodes_return;
	   Cardinal *keycount_return;

Inputs
  display     Specifies the display whose table is required.

  keysym      Specifies the keysym for which to search.

Outputs
  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.

Availability
  Release 4 and later.

Description
  XtKeysymToKeycodeList() returns all the keycodes that have the requested keysym in their entry in the  keyboard  mapping  table  associated
  with display.  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.

Usage
  The Translation Manager automatically converts between keycodes and keysyms.	Most applications will never have to use this function or its
  related functions.

  If you needs to examine the keycode-to-keysym table for a particular keycode, you can obtain the current table with XtGetKeysymTable().

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

Xt - Keyboard Handling													   XtKeysymToKeycodeList()