Skip to main content
All docs
V25.1
  • Report Viewer and Designer UI Localization

    • 2 minutes to read

    Web-based Report Designer and Report Viewer end-user dialogs available for the TdxReport component support JSON localization strings obtained from the DevExpress Localization Service.

    VCL Reports: A Localized Report Designer UI Example

    Add, Manage, and Download Translations

    Log into the DevExpress website to get started. Open the DevExpress Localization Service and click Add a Translation. Specify the required DevExpress component version (Version) and the target language (Preferred Language) in the displayed dialog as follows:

    VCL Reports: The Add Translation Dialog

    Repeat this step to include additional languages (if required).

    VCL Reports: A Translation List Example

    Click the Download button to build resources for all selected (checked) languages in the list of translations. Once the DevExpress Localization Service builds all required resources, an email containing links to these resources is sent to the address associated with your DevExpress account.

    Deploy and Apply UI Localizations

    To deploy all localizations with your application, do the following:

    1. Extract all downloaded localization resources from self-extracting archives you downloaded using links contained within the email. Each resource archive contains a json resources folder.

      Example Path: C:\Downloads\DevExpressLocalizedResources_2025.1_el\json resources (where the el culture identifier corresponds to Greek, de – to German, etc.)

    2. Create a Localization folder in the directory where your executable app file is located and copy extracted json resources/dxreporting.xx.json files into the folder for each target culture/language.

      Example Path: C:\Projects\ReportingApp\Localization\dxreporting.el.json

    3. Set the TdxReport.Language property to 'el-GR' (or any other ISO-based culture identifier):

      VCL Reports: The TdxReport.Language Property at Design Time

    Code Examples

    View Example: Localize the DevExpress Viewer and Report Designer

    Switch Between Languages at Runtime

    The code example in this section demonstrates three button OnClick event handlers that allow users to switch between the base language (English) and two localizations (Greek and Italian). Once the TdxReport.Language property value is changed, Report Designer and Report Viewer dialogs use the corresponding localization when displayed the next time.

    uses
      dxReport;  // Declares the TdxReport class
    // ...
    
    procedure TMyForm.btnEnglishClick(Sender: TObject);
    begin
      dxReport1.Language := 'en-US';
    end;
    
    procedure TMyForm.btnGreekClick(Sender: TObject);
    begin
      dxReport1.Language := 'el-GR';
    end;
    
    procedure TMyForm.btnItalianClick(Sender: TObject);
    begin
      dxReport1.Language := 'it-IT';
    end;
    
    See Also