TcxLocalizer.Locale Property

Specifies the application’s locale, according to the Windows system specification.

Declaration

property Locale: Cardinal read; write;

Property Value

Type
Cardinal

Remarks

Use this property to translate the application’s UI to another language, which is identified by ID. Locales and language IDs supported by Windows operating systems are listed at https://docs.microsoft.com/en-us/openspecs/windows_protocols/ms-lcid/a9eac961-e77d-41a6-90a5-ce1a8b0cdb9c.

At design time, the Locale property provides a drop-down list populated with the “English (Original translation)” locale (applied by default) and locales whose translations are available in the INI file specified using the FileName property. You can switch between the locales by selecting items from the list. To load locales from the specified INI file, set the Active and StorageType properties to True and lstIni, respectively. Note that locales whose translations are stored in a RES file (the StorageType property is set to lstResource) are loaded only at runtime.

The Locale, Language, and LanguageIndex properties are interchangeable, and mutually influence each other.

If a language has been dynamically changed at runtime, the localizer is automatically deactivated (the Active property is set to False). Set the Active property to True, to reactivate the localizer.