DevExpress Reports for Delphi/C++Builder — Localize the Report Viewer and Report Designer

This example localizes DevExpress VCL Reports components.

The DevExpress Reports for Delphi/C++Builder fully support UI localization. The localization example in this repository allows users to select between English (default) and German (localized) versions of two built-in DevExpress dialogs: Report Designer and Report Viewer. The example includes projects for both Delphi and C++Builder.

Prerequisites

DevExpress Reports Prerequisites

Implementation Details

To localize the DevExpress Report Designer and Report Viewer in your Delphi or C++Builder application, you must:

1. Use the [DevExpress UI Localization Service][localization-service] to obtain localization files for DevExpress VCL Report Viewer and Designer. These files contain UI string translations for specific languages/locales. Refer to the following guide to learn more: Localize Core Reporting Components: Use JSON Files.

2. Extract downloaded files to a localization folder next to your compiled application executable. Note that projects in this repository output their executables to the same location. This allows both projects to use the same localization files.

3. Assign a language identifier (also known as locale or culture identifier) to the TdxReport.Language property to switch the Report Designer/Report Viewer to the desired language:

   Delphi

   dxReport1: TdxReport;
   
   // Switch Report UI to German 
   dxReport1.Language := 'de-DE'

   C++Builder

   TdxReport *dxReport1;
   
   // Switch Report UI to German
   dxReport1->Language = "de-DE";

For a step-by-step guide, refer to the following help topic: Report Viewer and Designer UI Localization.

This example does not localize report content. To localize report content in your project, refer to the following guide: Report Content Localization.

The localization mechanism described in this example applies only to the DevExpress Report Designer and Report Viewer. Other DevExpress VCL components support localization using resource files and the Localizer Editor.

Files to Review

• uMainForm.pas (Delphi) and uMainForm.cpp (C++Builder) load an example report from ExampleReport.repx. Event handlers assigned to TcxRadioButton components switch localization language between English and German.
• localization/*.de.json files contain localized UI strings.

Documentation

• VCL Report Viewer and Designer UI Localization
• VCL Reports Localization
• DevExpress UI Localization Service
• ExpressReports Application Deployment Requirements
• API reference:
  • TdxReport
  • TdxReport.Layout
  • TdxReport.Language

More Examples

• Store Report Layouts in REPX Files
• Store Report Layouts in a Database

Localized Report Dialogs Preview

Localized Report Designer:

Localized Report Viewer:

Does This Example Address Your Development Requirements/Objectives?

(you will be redirected to DevExpress.com to submit your response)