Table of Contents

TMS FNC Localization Localizer

TTMSFNCLocalizationLocalizer is the runtime engine of TMS FNC Localization. Drop it on a form or data module and it loads your translation files, switches the active application language on demand, remembers the user's choice between runs, and notifies the rest of the application when the language changes. It is a non-visual component — pair it with the String Catalog and Collector to supply and gather translatable content, and with the Localization ComboBox to let users pick a language.

Documentation

Start here Use when
Getting started You want a working language switch quickly.
User guide You want task-oriented chapters: switching, start modes, persistence, and files.
API reference You want class, property, method, and event details.
Release notes You want the Localizer change history.

Quick start

Configure the localizer and apply the previously selected language:

procedure TDataModule1.DataModuleCreate(Sender: TObject);
begin
  { Localizer, Collector and StringCatalog are dropped on this data module at design time. }
  Localizer.LocalizationFolder := TPath.Combine(TPath.GetDocumentsPath, 'Translations');
  Localizer.LocalizationStartMode := lsmManual;
  Localizer.PersistLanguageSelection := True;

  { Apply the language the user selected on the previous run
    (falls back to the source language when nothing was persisted). }
  Localizer.PerformLocalization;
end;

Key classes

Class Role
TTMSFNCLocalizationLocalizer The runtime localization engine.
TTMSFNCLocalizationForm Base form that translates itself automatically in any framework.
TTMSFNCLocalizationStartMode Controls when localization is applied (manual, on idle, or automatic).

See also