Using the Translatable Property Browser

When a form defined in a schema with the forms management style of FormsMngmt_Single_Multi (2) is displayed in the JADE Painter and you select the Translate Properties command in the Window menu, the Translatable Property Browser is then displayed. This browser provides you with a quick mechanism to set up or assign translatable strings to the properties on a control.

Although you can use the Translatable Property Browser to specify new values for a control property, it is most useful when setting up properties with translatable strings so that different locales can have an easy translation mechanism for a single form.

The following is an example of the Translatable Property Browser.

Inherited controls are not shown in the browser.

The Item column at the left of the browser lists the names of the controls whose properties you can translate. The properties that are available for translation are displayed with a white background in cells for that control row; properties that are not available for translation for a control have a gray background in the cell of that control row.

Use the String Browser to maintain translatable strings associated with the current schema. (For details, see "Using the String Browser", in Chapter 11.) When you change a string definition in the String Browser of a control property displayed in the Translatable Property Browser (for example, from French to Japanese), the new translatable string definition is then displayed in the appropriate cell.

To change a property to use an existing translatable string

1. Perform one of the following actions.

   • Double-click the appropriate cell on the table

   • Select the cell and then press Shift+F6.

   The Select String dialog is then displayed. (For details about using this dialog, see "Inserting a Translatable String into an Existing JADE Method", in Chapter 4.)

2. In the Select String dialog, select the string that you want to use in the translation and then click the OK button.

   The selected translatable string is then displayed with a green background in the appropriate cell on the Translatable Property Browser.

3. To update the control properties for the form, click the Save button. (You must still save the form itself in the JADE Painter.)

The form is then displayed in the JADE Painter with the translated string values for the currently selected locale. (The current locale is displayed in the JADE Painter status line.)

To add a new translatable string to a property

1. Select the cell and then press F6.

   The Add String dialog is then displayed. (For details about adding a string, see "Adding Strings", in Chapter 11.)

2. In the Select String dialog, select the string that you want to use in the translation and then click the OK button.

   (For details about using this dialog, see "Inserting a Translatable String into an Existing JADE Method", in Chapter 4.)

The selected translatable string is then displayed with a green background in the appropriate cell on the Translatable Property Browser.