Grid-Localization-Support in WPF GridDataControl (Classic)

5 May 20213 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 the 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 Grid allows you to set custom resource through the Resx file. The user 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 Grid that does not affect the Code Block of the Grid

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 GridDataControl 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.Grid.Wpf..resx” E.g. Syncfusion.Grid.Wpf.en-GB.resx.
  3. Use the prescribed naming convention as it is mandatory.
  4. The following screenshot explains the addition of a Resource File to the application.

    Getting-Started_images159

  5. Select the String option in the Resource file. This is explained in the following screenshot.

    StringSelection

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

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

    Getting-Started_images161

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 Britain English Culture info. The following code snippet explains the implementation of this.

  • C#
  • public MainWindow()
    
    {
    
    	System.Threading.Thread.CurrentThread.CurrentUICulture = new               System.Globalization.CultureInfo("en-GB");
    
    
    
    	InitializeComponent();
    
    }

    Properties

    Localization Property Table

    Property Description Type Data Type
    AllowDrag Sets the string for AllowDrag property static string
    AllowDrag Sets the string for AllowDrag static string
    AllowGroup Sets the string for AllowGroup static string
    AllowResize Sets the string for AllowResize static string
    AllowSort Sets the string for AllowSort static string
    AND Sets the string for AND static string
    ApplyWidthSettings Sets the string for ApplyWidthSettings static string
    AutoFit Sets the string for AutoFit static string
    CanntPerformSortMessage Sets the string for CanntPerformSortMessage static string
    ClipboardCopyPaste Sets the string for ClipboardCopyPaste static string
    ColumnFormat Sets the string for ColumnFormat static string
    ConfirmDeleteMessage Sets the string for ConfirmDeleteMessage static string
    Contains Sets the string for Contains static string
    CurrentPageText Sets the string for CurrentPageText static string
    DeleteMessage Sets the string for DeleteMessage static string
    DragDropText Sets the string for DragDropText static string
    DynamicOptions Sets the string for DynamicOptions static string
    EndsWith Sets the string for EndsWith static string
    EnterFilterValue Sets the string for EnterFilterValue static string
    Equals Sets the string for Equals static string
    First Sets the string for First static string
    GreaterThan Sets the string for GreaterThan static string
    GreaterThanOrEqual Sets the string for GreaterThanOrEqual static string
    HCenter Sets the string for HCenter static string
    HeaderText Sets the string for HeaderText static string
    HLeft Sets the string for HLeft static string
    Horizontal Sets the string for Horizontal static string
    HRight Sets the string for HRight static string
    HStretch Sets the string for HStretch static string
    InvalidColumn Sets the string for InvalidColumn static string
    InvalidDataTime Sets the string for InvalidDataTime static string
    InvalidDataToFilter Sets the string for InvalidDataToFilter static string
    IsReadOnly Sets the string for IsReadOnly static string
    Last Sets the string for Last static string
    LessThan Sets the string for LessThan static string
    LessThanOrEqual Sets the string for LessThanOrEqual static string
    MatchCase Sets the string for MatchCase static string
    Next Sets the string for Next static string
    NoMoreItemRemoveMessage Sets the string for NoMoreItemRemoveMessage static string
    None Sets the string for None static string
    NoRecordsfound Sets the string for NoRecordsfound static string
    NotEnoughSpaceMessage Sets the string for NotEnoughSpaceMessage static string
    NotEquals Sets the string for NotEquals static string
    NotSupportDeletingItemMessage Sets the string for NotSupportDeletingItemMessage static string
    OR Sets the string for OR static string
    PageSizes Sets the string for PageSizes static string
    Previous Sets the string for Previous static string
    PrintOutputColor Sets the string for PrintOutputColor static string
    PrintText Sets the string for PrintText static string
    PrintZoom Sets the string for PrintZoom static string
    SelectAllFilter Sets the string for SelectAllFilter static string
    StartsWith Sets the string for StartsWith static string
    TextAlignment Sets the string for TextAlignment static string
    VBottom Sets the string for VBottom static string
    VCenter Sets the string for VCenter static string
    Vertical Sets the string for Vertical static string
    VStretch Sets the string for VStretch static string
    VTop Sets the string for VTop static string
    Width Sets the string for Width static string
    WidthOptions Sets the string for WidthOptions static string

    Refer to the sample in the shipped Sample Browser:

    Essential Studio - WPF Sample Browser - Grid - LocalizationSupport - LocalizationDemo.