NAME

XtAugmentTranslations − nondestructively merge new translations with widget’s existing ones. 

Synopsis

void XtAugmentTranslations(w, translations)

    Widget w;
    XtTranslations translations;

Inputs

wSpecifies 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", "#augment", 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 completely 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 "#override", 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). 

Copyright O’Reilly & Assoc.  —  X Toolkit Intrinsics Reference Manual © O’Reilly & Associates