Localization Support in WPF Chart (Classic)

5 May 20214 minutes to read

Localization is the process of making your application multi-lingual, by formatting content according to cultures. This involves configuring the application for a specific language. Culture is the combination of language and location (e.g. En-US is the culture for English spoken in United States; En-GB is the culture for English spoken in Great Britain). Syncfusion Chart allows you to set custom resource through the Resx file. You can simply give the string values in the resource file for a specific culture and set the culture in the application. The given string values are set to the Chart that does not affect the Code Block of the chart.

Use Case Scenario

The Essential Chart WPF can be localized according to the native language. It thus helps you to use the Chart more effectively.

Adding Localization to an Application

The following steps explain the implementation of Localization support in applications.

Creating an Application

Create a WPF application and add Chart control to it.

Creating a Resource File

To create a Resource file:

1. Create a folder named Resources in the application.
2. Create a resource file (Resx file) and name it Syncfusion.Chart.Wpf.resx E.g. Syncfusion.Chart.WPF.Ja.resx

Use the prescribed naming convention as it is mandatory.

The following screenshot explains the addition of a Resource file to the application.

Enter the “Name” and “Value” in the Resource file.

The String Property names used in the Chart are given in the Properties table. This is explained in the following screenshot.

Setting the Culture Information in the Application

The culture information should be set in the application before the InitializeComponent() method is called. Now, the application is set to Japanese Culture info. The following code example explains the implementation of this.

C#

System.Threading.Thread.CurrentThread.CurrentUICulture = new System.Globalization.CultureInfo("ja");

Property	Description	Type	Data Type
Analog	Sets the string for the Analog property	static	string
Area	Sets the string for the Area property	static	string
Bar	Sets the string for the Bar property	static	string
BoxAndWhisker	Sets the string for the Box and Whisker property	static	string
Bubble	Sets the string for the Bubble property	static	string
Candle	Sets the string for the Candle property	static	string
ChangeType	Sets the string for the ChangeType property	static	string
Close	Sets the string for the Close property	static	string
Colorful	Sets the string for the Colorful property	static	string
ColorPalette	Sets the string for the ColorPalette property	static	string
Column	Sets the string for the Column property	static	string
contextMenuPalettes	Sets the string for the ContextMenuPalette property	static	string
contextMenuSeries	Sets the string for the ContextMenuSeries property	static	string
contextMenuZoomAll	Sets the string for the ContextMenuZoomAll property	static	string
contextMenuZooming	Sets the string for the ContextmenuZooming property	static	string
Copy	Sets the string for the Copy property	static	string
Custom	Sets the string for the Custom property	static	string
Default	Sets the string for the Default property	static	string
DefaultAlpha	Sets the string for the DefaultAlpha property	static	string
Doughnut	Sets the string for the Dhoughnut property	static	string
EarthTone	Sets the string for the EarthTone property	static	string
EnableZooming	Sets the string for the EnableZooming property	static	string
FastColumn	Sets the string for the FastColumn property	static	string
FastHiLoOpenClose	Sets the string for the FastHiLoOpenClose property	static	string
FastLine	Sets the string for the FastLine property	static	string
FastScatter	Sets the string for the FastScatter property	static	string
FastStackingColumn	Sets the string for the FastStackingColumn property	static	string
Funnel	Sets the string for the Funnel property	static	string
Gantt	Sets the string for the Gantt property	static	string
Gradient	Sets the string for the Gradient property	static	string
Grayscale	Sets the string for the GrayScale property	static	string
HiLo	Sets the string for the HiLo property	static	string
HiLoArea	Sets the string for the HiLoArea property	static	string
HiLoOpenClose	Sets the string for the HiLoOpenClose property	static	string
Histogram	Sets the string for the Histogram property	static	string
Kagi	Sets the string for Kagi property	static	string
LegendWindowCancel	Sets the string for the LegendWindowControl property	static	string
LegendWindowCheckBox	Sets the string for the LegendWindowCheckBox property	static	string
LegendWindowIcon	Sets the string for the LegendWindowIcon property	static	string
LegendWindowOK	Sets the string for the legendWindowOk property	static	string
LegendWindowTitle	Sets the string for the LegendWindowTiltle property	static	string
Line	Sets the string for the Line property	static	string
Nature	Sets the string for the Nature property	static	string
Office2007Black	Sets the string for the Office2007Black property	static	string
Office2007Blue	Sets the string for the Office2007Blue property	static	string
Office2007Silver	Sets the string for the Office2007Silver property	static	string
Palette1	Sets the string for the Palette1 property	static	string
Palette2	Sets the string for the Palette2 property	static	string
Palette3	Sets the string for the Palette3 property	static	string
Palette4	Sets the string for the Palette4 property	static	string
Palette5	Sets the string for the Palette5 property	static	string
Palette6	Sets the string for the Palette6 property	static	string
Palette7	Sets the string for the Palette7 property	static	string
Palette8	Sets the string for the Palette8 property	static	string
Panning	Sets the string for the Panning property	static	string
Pastel	Sets the string for the Pastel property	static	string
Pie	Sets the string for the Pie property	static	string
PointAndFigure	Sets the string for the PointAndFigure property	static	string
Polar	Sets the string for the Polar property	static	string
printDialogAdvanced	Sets the string for the PrintDialogAdvanced property	static	string

Sample Link

To run the UI WPF Chart samples:

1. Open Essential Studio Dashboard by selecting Start -> Program -> Syncfusion-> Essential Studio «Version Number» -> Dashboard.
2. Click Run locally installed samples from the WPF drop-down list on the User Interface pane.
3. Select Chart on the sample browser.
4. Select User Interaction -> Localization Demo on the Essential Chart pane and click the Run Sample button.

To open the sample projects:

1. Go to the following sample location in your system:
2. “\Syncfusion\EssentialStudio\Version Number \WPF\Chart.WPF\Samples\3.5\WindowsSamples\User Interaction\Localization Demo”
3. This location contains two sub folders CS and VB. You can open the sample projects from the respective folders based on your application developing language.