Query: xtoverridetranslations
OS: hpux
Section: 1
Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar
XtOverrideTranslations() XtOverrideTranslations() Name XtOverrideTranslations - merge new translations, overriding a widget's existing ones. Synopsis void XtOverrideTranslations(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 XtOverrideTranslations() merges a compiled translation table translations into a widget's internal compiled translation table, replacing any existing translations that conflict with the new 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 without overriding existing translations where there are conflicts, use XtAugmentTranslations(). 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 "#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 XtAugmentTranslations(1), XtParseTranslationTable(1), XtUninstallTranslations(1). Xt - Translations and Actions XtOverrideTranslations()