|
1 | 1 | # WPF Spreadsheet localization demo |
2 | 2 |
|
3 | | -This repository contains sample project which shows localization of Syncfusion WPF SfSpreadsheet. |
| 3 | +This repository contains sample project which shows localization of Syncfusion WPF SfSpreadsheet. |
4 | 4 |
|
5 | | -Localization is the process of customizing the application to culture-specific. This involves configuring the application for the specific languages. Culture is the combination of Language and the Location (e.g. En-US is the Culture for English spoken at United States; En-GB is the Culture for English spoken at Great Britain). |
| 5 | +Localization is the process of configuring the application to a specific language. SfSpreadsheet provides support to localize all the static text in a Ribbon and all dialogs to any desired language. Localization can be done by adding resource file and setting the specific culture in the application. |
6 | 6 |
|
7 | | -[WPF Spreadsheet](https://www.syncfusion.com/spreadsheet-editor-sdk/wpf-spreadsheet-editor) (SfSpreadsheet) allows you to set custom resource through Resx file. You can give the string values in resource file for a specific Culture and set the Culture in the application. The given string values will be set to the Grid which does not affect the Code Block of the Grid. |
| 7 | +## Prerequisites |
8 | 8 |
|
9 | | -## Adding Localization to an Application |
| 9 | +Before running this project, ensure you have the following installed: |
10 | 10 |
|
11 | | -The following are steps to implementation Localization support to an application: |
| 11 | +- **Visual Studio** 2019 or later |
| 12 | +- **.NET Framework** 4.6.2 or greater |
| 13 | +- **.NET Core** 8.0 or greater |
12 | 14 |
|
13 | | -1. Create a WPF application and add spreadsheet control to it. |
14 | | -2. Create a folder named Resources in the application. |
15 | | -3. Create a resource file (Resx file) and name it as Syncfusion.Spreadsheet.WPF. .resx. Example: Syncfusion.Spreadsheet.WPF.ja.resx. |
16 | | -4. Select the String option in the Resource file. |
17 | | -5. Resource table will open. Enter the UI name in the Name column and the equivalent term you want in the Value column. |
18 | | -6. Assign the CultureInfo to the application before the InitializeComponent() method is being called. |
19 | | - The following code illustrates localizing the application to the Japanese CultureInfo. |
| 15 | +## Technologies Used |
20 | 16 |
|
21 | | -``` csharp |
22 | | -public MainPage() |
23 | | -{ |
24 | | - System.Threading.Thread.CurrentThread.CurrentUICulture = new System.Globalization.CultureInfo("ja-JP"); |
25 | | - |
26 | | - InitializeComponent(); |
27 | | -} |
| 17 | +- **WPF** (Windows Presentation Foundation) + **Syncfusion Spreadsheet** |
| 18 | + |
| 19 | +## Getting Started |
| 20 | + |
| 21 | +### 1. Clone the Repository |
| 22 | + |
| 23 | +Clone this repository to your local machine: |
| 24 | + |
| 25 | +```bash |
| 26 | +git clone https://github.com/your-username/wpf-spreadsheet-localization-demo.git |
| 27 | +cd wpf-spreadsheet-localization-demo |
| 28 | +``` |
| 29 | + |
| 30 | +### 2. Install Dependencies |
| 31 | + |
| 32 | +Install the required Syncfusion WPF Spreadsheet packages as dependencies: |
| 33 | + |
| 34 | +```bash |
| 35 | +dotnet add package Syncfusion.SfSpreadsheet.WPF |
| 36 | +dotnet add package Syncfusion.SfSpreadsheetHelper.WPF |
28 | 37 | ``` |
29 | | -7. Add Supported Cultures to the Application |
30 | 38 |
|
31 | | -The following are the steps to add Supported Cultures: |
| 39 | +Alternatively, you can restore packages using: |
| 40 | + |
| 41 | +```bash |
| 42 | +dotnet restore |
| 43 | +``` |
| 44 | + |
| 45 | +### 3. Run the Application |
| 46 | + |
| 47 | +Run the project and test the feature directly from the WPF app: |
| 48 | + |
| 49 | +```bash |
| 50 | +dotnet run |
| 51 | +``` |
| 52 | + |
| 53 | +Or open the solution in Visual Studio and press `F5` to build and run the application. |
| 54 | + |
| 55 | +## Resources |
32 | 56 |
|
33 | | -1. In the Solution Explorer, right-click application project and choose Unload Project from the Context Menu. The project will be unloaded. |
34 | | -2. Right click the project again, and select the Edit .csproj option. Example: LocalizationSample WPF.csproj |
35 | | -3. In the .csproj file, find the tags. Default the tags will be empty. So, add the required cultures. Use semicolon to separate if you want to add multiple culture. Example: en-GB;de;hi;es;it;Ja |
36 | | -4. Save the project. |
37 | | -5. Right click the .csproj and choose Reload .csproj. Project will be added with specific culture. |
| 57 | +- https://help.syncfusion.com/document-processing/excel/spreadsheet/wpf/getting-started |
| 58 | +- https://help.syncfusion.com/document-processing/excel/spreadsheet/wpf/localization |
0 commit comments