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()
