xtrareports-401573-feature-guide-to-devexpress-reports-globalize-and-localize-reports-localize-reports.md
This document describes how to localize a report that targets different languages and cultures.
The localization technique described in this topic uses localized strings serialized with the report layout. Call the XtraReport.SaveLayout method to save localized strings in REPX format with the report’s layout.
To view the localized report, refer to the following DevExpress WinForms demo:
Run Demo: Vehicle Inspection Report
A localized report can display text based on different cultures. You can localize the text properties in the Lolization Editor.
Tip
Text property to localize controls that display static text.TextFormatString property to localize data-bound controls.You can also localize the following attributes of reports and report controls:
For the full list of localizable properties, refer to the following section: Localizable Properties.
To localize a report, follow the steps below:
Use the Properties window to set the report’s Language property to a value other than Default.
In the Property Window, click the Localizable Properties toolbar button to display only localizable properties in the Properties window (see the image below).
Change the control’s localizable property values. You can also move and resize the control.
Save the report.
When a Document Viewer loads a localized report, the document contains modifications that match the application’s culture.
To determine whether a report contains localized settings, or to access the localized version, use the Localization -> Language drop-down list.
The Report Designer always loads a report in the Default language. You can change the language in the Localization Editor or set the report’s language as described in the previous section. Then, switch to the Preview tab to view the localized document.
To preview a localized report in your application, use one of the following methods:
Specify the report’s culture. The method depends on the application platform:
Invoke a preview window or use a Document Viewer control to load a localized report. Refer to the following topics for more information:
A localized report contains localization items - objects that combine the control, language, property, and value. A value is attributed to a default language if it is not related to any language. Localization items are contained in the XtraReport.LocalizationItems collection.
Note
You cannot localize properties of Inherited Reports.
Localizable properties are annotated with the DevExpress.XtraReports.Localization.XRLocalizableAttribute custom attribute: [XRLocalizable(true)]
The following properties are localizable:
GroupLayoutItem.Title