Skip to content

Commit 7d8af38

Browse files
committed
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>
1 parent f0a5226 commit 7d8af38

4 files changed

Lines changed: 40 additions & 4 deletions

File tree

README.md

Lines changed: 40 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,40 @@
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 demonstrates how to localize DevExpress VCL Reports components in Delphi and C++ Builder projects.
11+
12+
The projects in this repository add German localization to DevExpress VCL dialogs:
13+
[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+
Both dialogs are parts of the [DevExpress Reporting Platform](https://docs.devexpress.com/VCL/405469/ExpressReports/vcl-reports),
16+
which has full support for UI localization.
17+
18+
![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)
19+
20+
## Prerequisites
21+
22+
* Microsoft Windows 10 or newer
23+
* Embarcadero RAD Studio IDE 12.3 (Athens) or newer (Community Edition is not supported)
24+
* DevExpress VCL Components v25.2.3 or newer
25+
* EdgeView2SDK (installed via GetIt Package Manager)
26+
27+
## Implementation Details
28+
29+
Study and build an example project in your preferred development environment:
30+
31+
- [Delphi](./Delphi)
32+
- [C++ Builder](./CPB)
33+
34+
A compiled application obtains the strings for the German (`de_DE`) locale from the
35+
[`./Localization/*.de.json`](./Localization) files.
36+
You can use the [DevExpress Localization Service](https://localization.devexpress.com/) to download localization files for
37+
German and multiple other locales.
1238

1339
## Documentation
1440

@@ -17,6 +43,16 @@ This example localizes DevExpress VCL [Report Viewer](https://docs.devexpress.co
1743
* [DevExpress UI Localization Service](https://docs.devexpress.com/GeneralInformation/16235/localization/localization-service)
1844
* [TdxReport.Language Property](https://docs.devexpress.com/VCL/dxReport.TdxReport.Language)
1945

46+
## Localized Report Dialogs Preview
47+
48+
Localized Report Designer:
49+
50+
![VCL Report Designer dialog with interface localized in German language](./images/Berichtsdesigner.png)
51+
52+
Localized Report Viewer:
53+
54+
![VCL Report Viewer dialog with interface localized in German language](./images/Berichtsanzeige.png)
55+
2056
<!-- feedback -->
2157
## Does this example address your development requirements/objectives?
2258

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)