XtParseTranslationTable(Xt) 6 January 1993 XtParseTranslationTable(Xt)
X Version 11 (Release 5)
Name
XtParseTranslationTable - manage translation tables
Syntax
XtTranslations XtParseTranslationTable(table)
String table;
void XtAugmentTranslations(w, translations)
Widget w;
XtTranslations translations;
void XtOverrideTranslations(w, translations)
Widget w;
XtTranslations translations;
void XtUninstallTranslations(w)
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 trans-
lations into the existing widget translations. If the new translations
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 transla-
tions into the existing widget translations. If the new translations
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 specifiy a compiled translation table as the
value.
The XtUninstallTranslations function causes the entire translation table
for widget to be removed.
See also
XtAppAddActions(Xt), XtCreatePopupShell(Xt), XtParseAcceleratorTable(Xt)
and XtPopup(Xt).
X Toolkit Intrinsics - C Language Interface
Xlib - C Language X Interface