hpux man page for xtaugmenttranslations

XtAugmentTranslations() 												   XtAugmentTranslations()

Name
  XtAugmentTranslations - nondestructively merge new translations with widget's existing ones.

Synopsis
  void XtAugmentTranslations(w, translations)
	 Widget w;
	 XtTranslations translations;

Inputs
  w	      Specifies the widget into which the new translations are to be merged.  Must be of class Core or any subclass thereof.

  translations
	      Specifies the compiled translation table to merge in.

Description
  XtAugmentTranslations()  merges a compiled translation table translations into a widget's internal compiled translation table, ignoring any
  new translations that conflict with existing translations.  The table translations is not altered by this process.  Any "#replace",  "#aug-
  ment", or "#override" directives in translations are ignored by this function.

Usage
  Use XtParseTranslationTable() to convert a string representation of a translation table to the XtTranslations compiled form.

  To  merge  translations  into  a widget and replace existing translations where there are conflicts, use XtOverrideTranslations().  To com-
  pletely replace a widget's translation table, use XtSetValues() to set  a  compiled  translation  table  on  the  widget's  XtNtranslations
  resource.  To remove all of a widget's translations, use XtUninstallTranslations().

  Translation tables can also be specified in string from a resource file.  By default, specifying a value for the translations resource will
  completely replace the existing translations.  If the string form of the translation table begins with the directives "#augment" or "#over-
  ride",  however, then the specified translations will be merged with the widget's existing translations, and new translations that conflict
  with existing translations will be ignored or will override the existing translations, respectively.

See Also
  XtOverrideTranslations(1), XtParseTranslationTable(1), XtUninstallTranslations(1).

Xt - Translations and Actions												   XtAugmentTranslations()