# Translations

The Translations dialog provides the means of associating specific user events with Actions defined for a widget.

The dialog contains two Scrolled Text regions for entering your Translations: an Override Translations area and a Augment Translations section. Any Translations specified in the Augment section only take effect if there does not already exist a Translation for the event. Override Translations always take effect.

A Translation entered into the dialog is relatively simple in format and consists of a key sequence followed by a list of Actions. For example:

        <Key>q: ArmAndActivate()

        <Btn1Down>: Activate()

        <Key>k: MyActionA()

You can replace the existing Translations for a widget by setting the Replace toggle at the top left of the dialog.

If you want to apply the same Translations to a number of widgets, set the Retain toggle: the current set of Translations will be remembered across calls to the dialog, so you can select each of your widgets and Apply the Translations in turn.

You can search for a string in a Translation across all the widgets in your design by using the search facility.

NOTES

The built-in Actions supported by the Motif widgets (the Activate and ArmAndActivate Actions in the examples) are documented in the Motif Reference Manual in the "Default Translations" section for each widget. You can add extra Actions of your own using XtAppAddActions().

Any user-defined Actions specified within a Translation dialog will not be known to WorkShop Visual, so that when in WorkShop Visual you Apply the Translation, an error message will be generated for the relevant Actions. However, this does not mean that your Translations have been lost: they will appear in generated code correctly. Note that no error is generated when you Apply an Action which is built-in to a Motif widget.

Please consult Motif and X Toolkit Intrinsics documentation for more information concerning Translations and Actions.

See also:

- Search
- About WorkShop Visual