getRootSchemaFormTranslation(formName: String;
entityName: String): String;
The getRootSchemaFormTranslation method of the Application class returns the text to be displayed as the form, menu, or control caption specified by the entityName parameter on the form specified by the formName parameter.
You can translate captions for the following system forms and dialogs only (related to printing or the use of the
Print Options dialog
Select Pages To Print dialog
Find Text dialog
Print Preview Find message box
Print dialog
Find and Replace dialog (Rich text control)
Paragraph formatting dialog (Rich text control)
Insert Table dialog (Rich text control)
Popup menu (Rich text control)
The getRootSchemaFormTranslation method dynamically loads the captions of all required entities when a form is created and when logic dynamically changes a caption.
To handle translation to another language, your application must re-implement the getRootSchemaFormTranslation method and return appropriate translations for each requested entity.
A copy of the default getRootSchemaFormTranslation method is provided in the RootSchemaFormTranslation subdirectory of the examples directory on the JADE release medium, with the getRootSchemaFormTranslation.mth file name. Any subsequent changes to this method will be documented in the JADE release information.
A caption can include an accelerator key (for example; ‘&Cancel’). Translations must return a string with a unique accelerator that is appropriate to the language.
Captions with carriage return and line feed characters have ‘%Cr%Lf’ markers included in the default text. You should retain these markers.
Some captions have parameter markers; for example, ‘Print Preview page %1 of %2 pages’. In this example, the %<n> value is a number in the range 1 through 9, to indicate where the parameter value is to be inserted. Your translations should retain these parameter markers so that subsequent logic can insert the required text.