XtParseTranslationTable(3Xt) XtParseTranslationTable(3Xt)
NAME
XtParseTranslationTable, XtAugmentTranslations,
XtOverrideTranslations, XtUninstallTranslations -
manage translation tables
SYNOPSIS
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 translations 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 translations into the existing widget
translations. If the new translations contain an event
or event sequence that already exists in the widget's
translations, then the new translation is merged in and
overrides the widget's translation.
To replace a widget's translations completely, use
- 1 -
XtParseTranslationTable(3Xt) XtParseTranslationTable(3Xt)
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(3Xt), XtCreatePopupShell(3Xt),
XtParseAcceleratorTable(3Xt), XtPopup(3Xt)
X Toolkit Intrinsics Programming Manual
Xlib Programming Manual
- 2 -