setJadeLocale

setJadeLocale(requestedLcid : Integer) updating;

The setJadeLocale method of the Application class dynamically changes the effective locale to the Locale Identifier (LCID) specified in the requestedLcid parameter for forms and translatable strings. For details about the commonly used locale identifier (LCID) global constants, see the JadeLocaleIdNumbers category, in Appendix A of the JADE Encyclopaedia of Primitive Types.

For example, if you want to translate to English (United States) and retain the English (United Kingdom) locale of your operating system, you could use another locale such as Belgian Dutch (the LCID_Dutch_Belgium global constant) for the translation.

If the value of the requestedLcid parameter is:

• A valid locale identifier, the Application class currentLocale is changed.

  If enhanced locale support is enabled, the currentLocaleInfo properties and the current thread locale are updated. The current thread locale identifier affects date, time, numeric, and currency parsing and formatting, and is returned by the Schema class getCurrentLocaleId method.

• Invalid or not installed, an exception is raised.

  If enhanced locale support is enabled, validation occurs on the application server and the presentation client.

• Zero (0), locale information for the current locale is refreshed.

• Not contained in the schema, the currentLocale property is set to the current schema default locale. (The value of the currentLocale property will be different from the current thread locale identifier obtained from the Schema class getCurrentLocaleId method.)

• The current thread locale identifier, regional overrides for the session locale, if currently in use, are not applied.

• The LCID_SessionWithOverrides global constant, regional overrides for the session locale, if currently in use, are applied.