Skip to content

Commit 9afff29

Browse files
committed
readme: Provide links to documentation; add a note about VCL library
localization
1 parent 5051e22 commit 9afff29

1 file changed

Lines changed: 24 additions & 6 deletions

File tree

README.md

Lines changed: 24 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -7,11 +7,17 @@
77

88
# DevExpress VCL Reports - Localize the Report Viewer and Report Designer
99

10-
This example localizes DevExpress VCL Reports components in Delphi and C++ Builder projects.
10+
This example localizes DevExpress VCL Reports components in [Delphi](./Delphi) and [C++ Builder](./CPB) projects.
1111

1212
The [DevExpress Reporting Platform](https://docs.devexpress.com/VCL/405469/ExpressReports/vcl-reports)
1313
fully supports UI localization. Projects in this repository give users a choice between English (default) and German (localized) versions of two built-in dialogs: [Report Viewer](https://docs.devexpress.com/XtraReports/401850/web-reporting/web-document-viewer) and
14-
[Report Designer](https://docs.devexpress.com/XtraReports/119176/web-reporting/web-end-user-report-designer).
14+
[Report Designer](https://docs.devexpress.com/XtraReports/119176/web-reporting/web-end-user-report-designer).
15+
16+
**To localize the DevExpress Report Designer and Report Viewer interface** in your Delphi or C++ Builder project, refer to the following guide:
17+
[Report Viewer and Designer UI Localization](https://docs.devexpress.com/VCL/405598/ExpressReports/localization/vcl-report-viewer-and-designer-localization).
18+
19+
**To localize the report contents**, refer to the following guide:
20+
[Report Localization](https://docs.devexpress.com/VCL/405599/ExpressReports/localization/vcl-report-localization).
1521

1622
![Starting screen of the localization example, offering to select between English and German, and to display Report Designer and Report Viewer dialogs](./images/Lokalisierungsbeispiel.png)
1723

@@ -24,12 +30,24 @@ fully supports UI localization. Projects in this repository give users a choice
2430

2531
## Implementation Details
2632

27-
Study and build an example project in your preferred development environment:
33+
To switch the Report Designer and Report Viewer interface to a different language,
34+
assign the language code to the [`Language`](https://docs.devexpress.com/VCL/dxReport.TdxReport.Language) property of a [`TdxReport`](https://docs.devexpress.com/VCL/dxReport.TdxReport) component:
35+
36+
```delphi
37+
dxReport1: TdxReport;
38+
// Switch to German Localization
39+
dxReport1.Language := 'de-DE'
40+
```
41+
42+
A compiled application obtains UI strings for the German locale (`de_DE`) from the following files: [`./Localization/*.de.json`](./Localization).
43+
Learn more about the localization files required for each component from the following guide:
44+
[Localize Core Reporting Components: Use JSON Files](https://docs.devexpress.com/XtraReports/400932/web-reporting/common-features/localization/localization-in-asp-net-core-reporting-applications#use-json-files).
2845

29-
- [Delphi](./Delphi)
30-
- [C++ Builder](./CPB)
46+
To download localization files for various locales, you can use the [DevExpress Localization Service](https://localization.devexpress.com/).
47+
Learn more from the following guide: [DevExpress UI Localization Service](https://docs.devexpress.com/GeneralInformation/16235/localization/localization-service).
3148

32-
A compiled application obtains UI strings for the German locale (`de_DE`) from the following files: [`./Localization/*.de.json`](./Localization). You can use the [DevExpress Localization Service](https://localization.devexpress.com/) to download localization files for various locales.
49+
> **Note:** The localization mechanism demonstrated in this example applies only to DevExpress Report Designer and Report Viewer components.
50+
> The DevExpress VCL library components support localization using [resource files and the Localizer Editor](https://docs.devexpress.com/VCL/154039/ExpressCrossPlatformLibrary/how-to/localize-an-application).
3351
3452
## Documentation
3553

0 commit comments

Comments
 (0)