Skip to content

Commit 84174e2

Browse files
readme: Explain example purpose and restructure
- Explain the localization mechanism in more detail. - Provide screenshots of localized Report Designer and Report viewer. Signed-off-by: Nick Volynkin <nikolay.volynkin@devexpress.com> Co-authored-by: Vladimir Abadzhev <vladimira@devexpress.com>
1 parent 65b0fe2 commit 84174e2

4 files changed

Lines changed: 36 additions & 4 deletions

File tree

README.md

Lines changed: 36 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,53 @@
11
<!-- default badges list -->
22
![](https://img.shields.io/endpoint?url=https://codecentral.devexpress.com/api/v1/VersionRange/1048527919/25.2.3%2B)
33
[![](https://img.shields.io/badge/Open_in_DevExpress_Support_Center-FF7200?style=flat-square&logo=DevExpress&logoColor=white)](https://supportcenter.devexpress.com/ticket/details/T1305951)
4-
[![](https://img.shields.io/badge/📖_How_to_use_DevExpress_Examples-e9f6fc?style=flat-square)](https://docs.devexpress.com/GeneralInformation/403183)
4+
[![](https://img.shields.io/badge/📖_How_to_use_DevExpress_Examples-e9f6fc?style=flat-square)](https://docs.devexpress.com/GeneralInformation/403183/help-resources/devexpress-code-examples)
55
[![](https://img.shields.io/badge/💬_Leave_Feedback-feecdd?style=flat-square)](#does-this-example-address-your-development-requirementsobjectives)
66
<!-- default badges end -->
7-
# DevExpress VCL Reports - Localize the DevExpress Report Viewer and Report Designer
87

9-
This example localizes DevExpress VCL [Report Viewer](https://docs.devexpress.com/XtraReports/401850/web-reporting/web-document-viewer)/[Report Designer](https://docs.devexpress.com/XtraReports/119176/web-reporting/web-end-user-report-designer) dialogs ([TdxReport](https://docs.devexpress.com/VCL/dxReport.TdxReport) component). German UI localization strings are stored within the project's [Localization](https://github.com/DevExpress-Examples/vcl-reports-localize/tree/25.1.4%2B/Localization) folder as JSON files. You can download UI localizations for additional languages from the [DevExpress Localization Service](https://localization.devexpress.com/).
8+
# DevExpress VCL Reports - Localize the Report Viewer and Report Designer
109

11-
<img width="1049" height="697" alt="vcl-reports-tdxreport-report-viewer-localization" src="https://github.com/user-attachments/assets/8e2366ae-501e-4b53-a8d9-865ba7155a2c" />
10+
This example localizes DevExpress VCL Reports components in Delphi and C++ Builder projects.
11+
12+
The [DevExpress Reporting Platform](https://docs.devexpress.com/VCL/405469/ExpressReports/vcl-reports)
13+
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).
15+
16+
![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)
17+
18+
## Prerequisites
19+
20+
* Microsoft Windows 10 or newer
21+
* Embarcadero RAD Studio IDE 12.3 (Athens) or newer (Community Edition is not supported)
22+
* DevExpress VCL Components v25.2.3 or newer
23+
* EdgeView2SDK (installed via GetIt Package Manager)
24+
25+
## Implementation Details
26+
27+
Study and build an example project in your preferred development environment:
28+
29+
- [Delphi](./Delphi)
30+
- [C++ Builder](./CPB)
31+
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.
1233

1334
## Documentation
1435

1536
* [VCL Report Viewer and Designer UI Localization](https://docs.devexpress.com/VCL/405598/ExpressReports/localization/vcl-report-viewer-and-designer-localization)
1637
* [VCL Reports Localization](https://docs.devexpress.com/VCL/405597/ExpressReports/vcl-reports-localization)
1738
* [DevExpress UI Localization Service](https://docs.devexpress.com/GeneralInformation/16235/localization/localization-service)
1839
* [TdxReport.Language Property](https://docs.devexpress.com/VCL/dxReport.TdxReport.Language)
40+
* [ExpressReports Application Deployment Requirements](https://docs.devexpress.com/VCL/405469/ExpressReports/vcl-reports#expressreports-app-deployment)
41+
42+
## Localized Report Dialogs Preview
43+
44+
Localized Report Designer:
45+
46+
![VCL Report Designer dialog with interface localized in German language](./images/Berichtsdesigner.png)
47+
48+
Localized Report Viewer:
49+
50+
![VCL Report Viewer dialog with interface localized in German language](./images/Berichtsanzeige.png)
1951

2052
<!-- feedback -->
2153
## Does this example address your development requirements/objectives?

images/Berichtsanzeige.png

83.5 KB
Loading

images/Berichtsdesigner.png

143 KB
Loading

images/Lokalisierungsbeispiel.png

23.6 KB
Loading

0 commit comments

Comments
 (0)