xtaugmenttranslations(1) [hpux man page]
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()
Check Out this Related Man Page
XtParseTranslationTable(3) XT FUNCTIONS XtParseTranslationTable(3) NAME
XtParseTranslationTable, XtAugmentTranslations, XtOverrideTranslations, XtUninstallTranslations - manage translation tables SYNTAX
XtTranslations XtParseTranslationTable(String table); void XtAugmentTranslations(Widget w, XtTranslations translations); void XtOverrideTranslations(Widget w, XtTranslations translations); void XtUninstallTranslations(Widget w); ARGUMENTS
table Specifies the translation table to compile. translations Specifies the compiled translation table to merge in (must not be NULL). w Specifies the widget into which the new translations are to be merged or removed. DESCRIPTION
The XtParseTranslationTable function compiles the translation table into the opaque internal representation of type XtTranslations. Note that if an empty translation table is required for any purpose, one can be obtained by calling XtParseTranslationTable and passing an empty string. The XtAugmentTranslations function nondestructively merges the new translations into the existing widget translations. If the new transla- tions contain an event or event sequence that already exists in the widget's translations, the new translation is ignored. The XtOverrideTranslations function destructively merges the new translations into the existing widget translations. If the new transla- tions contain an event or event sequence that already exists in the widget's translations, the new translation is merged in and override the widget's translation. To replace a widget's translations completely, use XtSetValues on the XtNtranslations resource and specify a compiled translation table as the value. The XtUninstallTranslations function causes the entire translation table for widget to be removed. SEE ALSO
XtAppAddActions(3), XtCreatePopupShell(3), XtParseAcceleratorTable(3), XtPopup(3) X Toolkit Intrinsics - C Language Interface Xlib - C Language X Interface X Version 11 libXt 1.1.3 XtParseTranslationTable(3)