Localization

Localization is the process of translating the application resources into different languages for some specific cultures. The EditControl supports complete localization to any desired language of all the dialogs boxes and strings associated with it. It can be localized by using the ILocalizationProvider.

Follow the steps to localize the dialog boxes in the EditControl:

1. Include the required namespaces at the beginning of the file.

using Syncfusion.Windows.Forms;
using Syncfusion.Windows.Forms.Edit;
Imports Syncfusion.Windows.Forms
Imports Syncfusion.Windows.Forms.Edit

2. Create a class that implements the ILocalizationProvider interface defined in the Syncfusion.Windows.Forms namespace.

3. Return the localized versions of the string corresponding to the string identifiers.

4. String identifiers are defined in the ResourceIdentifiers and the EditResourceIdentifiers classes in Syncfusion.Shared.Base and Syncfusion.Edit.Windows assemblies respectively.

using Syncfusion.Windows.Forms.Localization.Localizer.EditResourceIdentifiers;
using Syncfusion.Windows.Forms.ResourceIdentifiers;
Imports Syncfusion.Windows.Forms.Localization.Localizer.EditResourceIdentifiers
Imports Syncfusion.Windows.Forms.ResourceIdentifiers

5. Assign this instance to the Provider property of the LocalizationProvider class before the InitializeComponent call in the constructor of the application.

LocalizationProvider.Provider = new Localizer();
LocalizationProvider.Provider = New Localizer()

6. The following code example demonstrates localizing various dialog boxes in the EditControl.

Find Dialog Box

Provides Microsoft Visual Studio text editor like FindDialog window with similar options for text searching and highlighting.

For example: Here, FindDialog is localized in German language.

public string GetLocalizedString(System.Globalization.CultureInfo culture, string name,object obj)

{

switch (name)

{

case Localizer.EditResourceIdentifiers.FDbtnClose:

return "schließen";

case Localizer.EditResourceIdentifiers.FDbtnFind:

return "finden";

case Localizer.EditResourceIdentifiers.FDbtnMarkAll:

return "markieren Sie alle";              

case Localizer.EditResourceIdentifiers.FDchkCase:

return "übereinstimmen Fall";               

case Localizer.EditResourceIdentifiers.FDchkHidden:

return "Suche hidden";

case Localizer.EditResourceIdentifiers.FDchkRegular:

return "Suche regelmäßige";

case Localizer.EditResourceIdentifiers.FDchkUp:

return "Suche Up";

case Localizer.EditResourceIdentifiers.FDchkWholeWord:

return "Ganzes Wort";

case Localizer.EditResourceIdentifiers.FDchkWrap:

return "Zeilenumbruch";

case Localizer.EditResourceIdentifiers.FDGroupTitle:

return "Suchen";

case Localizer.EditResourceIdentifiers.FDMain:

return "Startseite";

case Localizer.EditResourceIdentifiers.FDrdbDocument:

return "Document";

case Localizer.EditResourceIdentifiers.FDrdbSelection:

return "Auswahl";

case Localizer.EditResourceIdentifiers.FDTitle:

return "Kommentar";
             
default:

return string.Empty;

}

}
Public Function GetLocalizedString(ByVal culture AsSystem.Globalization.CultureInfo, ByVal name As String, ByVal obj As Object) AsString

Select Case name

Case Localizer.EditResourceIdentifiers.FDbtnClose

Return "schließen"

Case Localizer.EditResourceIdentifiers.FDbtnFind

Return "finden"

Case Localizer.EditResourceIdentifiers.FDbtnMarkAll

Return "markieren Sie alle"

Case Localizer.EditResourceIdentifiers.FDchkCase

Return "übereinstimmen Fall"

Case Localizer.EditResourceIdentifiers.FDchkHidden

Return "Suche hidden"

Case Localizer.EditResourceIdentifiers.FDchkRegular

Return "Suche regelmäßige"

Case Localizer.EditResourceIdentifiers.FDchkUp

Return "Suche Up"

Case Localizer.EditResourceIdentifiers.FDchkWholeWord

Return "Ganzes Wort"

Case Localizer.EditResourceIdentifiers.FDchkWrap

Return "Zeilenumbruch"

Case Localizer.EditResourceIdentifiers.FDGroupTitle

Return "Suchen"

Case Localizer.EditResourceIdentifiers.FDMain

Return "Startseite"

Case Localizer.EditResourceIdentifiers.FDrdbDocument

Return "Document"

Case Localizer.EditResourceIdentifiers.FDrdbSelection

Return "Auswahl"

Case Localizer.EditResourceIdentifiers.FDTitle

Return "Kommentar"

Case Else

Return String.Empty

End Select

End Function

Localized find dialog box in syntax editor

Replace Dialog Box

Provides Microsoft Visual Studio text editor like Find and Replace dialog window with similar options for text searching, highlighting, and replacing.

For example: Here, ReplaceDialog is localized in Chinese language.

public string GetLocalizedString(System.Globalization.CultureInfo culture, string name,object obj)
{

switch (name)
{

case Localizer.EditResourceIdentifiers.FRTitle:
return "更换";

case Localizer.EditResourceIdentifiers.FRrdbSelection:
return "全部替换";
                
case Localizer.EditResourceIdentifiers.FRbtnReplace:
return "更换";
                
case Localizer.EditResourceIdentifiers.FRbtnReplaceAll:
return "全部替换";

case Localizer.EditResourceIdentifiers.FRGroupTitle:
return "全部替换";

case Localizer.EditResourceIdentifiers.FRbtnClose:
return "全部替换";

case Localizer.EditResourceIdentifiers.FRlblFind:
return "全部替换";

case Localizer.EditResourceIdentifiers.FRlblReplace:
return "全部替换";

}

}
Public Function GetLocalizedString(ByVal culture AsSystem.Globalization.CultureInfo, ByVal name As String, ByVal obj As Object) AsString

Select Case name

Case Localizer.EditResourceIdentifiers.FRTitle
Return "更换"

Case Localizer.EditResourceIdentifiers.FRrdbSelection
Return "全部替换"
                
Case Localizer.EditResourceIdentifiers.FRbtnReplace
Return "更换"
                
Case Localizer.EditResourceIdentifiers.FRbtnReplaceAll
Return "全部替换"

Case Localizer.EditResourceIdentifiers.FRGroupTitle
Return "全部替换"

Case Localizer.EditResourceIdentifiers.FRbtnClose
Return "全部替换

Case Localizer.EditResourceIdentifiers.FRlblFind
Return "全部替换"

Case Localizer.EditResourceIdentifiers.FRlblReplace
Return "全部替换"

End Select

End Function

Localized replace dialog box in syntax editor

GoTo Dialog Box

Provides GoToLine dialog window to navigate to the required line number.

For example: Here, GoToDialog is localized in Chinese language.

public string GetLocalizedString(System.Globalization.CultureInfo culture, string name,object obj)
{

switch (name)
{

case Localizer.EditResourceIdentifiers.FGoTitle:
return "去线";

case Localizer.EditResourceIdentifiers.FGoNumber:
return "电话号码{0}-{1}";

case Localizer.EditResourceIdentifiers.FGobtnOK:
return "好";

case Localizer.EditResourceIdentifiers.FGobtnCancel:
return "取消";

}

}
Public Function GetLocalizedString(ByVal culture AsSystem.Globalization.CultureInfo, ByVal name As String, ByVal obj As Object) AsString

Select Case name

Case Localizer.EditResourceIdentifiers.FGoTitle
Return "去线"

Case Localizer.EditResourceIdentifiers.FGoNumber
Return "电话号码{0}-{1}"

Case Localizer.EditResourceIdentifiers.FGobtnOK
Return "好"

Case Localizer.EditResourceIdentifiers.FGobtnCancel
Return "取消"

End Select

End Function

Localized GoTo dialog box in syntax editor

Context Menu

Provides a built-in context menu with options to perform editing operations like undo, redo, cut, copy, paste, select all, and so on.

For example: Here, ContextMenu is localized in Chinese language.

public string GetLocalizedString(System.Globalization.CultureInfo culture, string name,object obj)
{

      switch (name)
      {

               case Localizer.EditResourceIdentifiers.DEF_MENU_BOOKMARKS:
               return "上下文菜单书签";

                case Localizer.EditResourceIdentifiers.DEF_MENU_CLEARBOOKMARKS:
                    return "清除书签";

                case Localizer.EditResourceIdentifiers.DEF_MENU_CLOSE:
                    return "上下文菜单关";

                case Localizer.EditResourceIdentifiers.DEF_MENU_COLLAPSEALL:
                    return "上下文菜单坍方";

                case Localizer.EditResourceIdentifiers.DEF_MENU_COMMENTSELECTION:
                    return "上下文菜单评论选择";

                case Localizer.EditResourceIdentifiers.DEF_MENU_COPY:
                    return "上文菜单评论";

                case Localizer.EditResourceIdentifiers.DEF_MENU_CUT:
                    return "切";

                case Localizer.EditResourceIdentifiers.DEF_MENU_DELETE:
                    return "删除";

                case Localizer.EditResourceIdentifiers.DEF_MENU_DELETEALL:
                    return "删除所有";

                case Localizer.EditResourceIdentifiers.DEF_MENU_EDIT:
                    return "编辑";

                case Localizer.EditResourceIdentifiers.DEF_MENU_FILE:
                    return "文件";
                    
                case Localizer.EditResourceIdentifiers.DEF_MENU_EXPANDALL:
                    return "展开全部";

                case Localizer.EditResourceIdentifiers.DEF_MENU_FIND:
                    return "找";

                case Localizer.EditResourceIdentifiers.DEF_MENU_GOTO:
                    return "去";

                case Localizer.EditResourceIdentifiers.DEF_MENU_INDENTSELECTION:
                    return "缩进选择";

                case Localizer.EditResourceIdentifiers.DEF_MENU_NEW:
                    return "新";

                case Localizer.EditResourceIdentifiers.DEF_MENU_OPEN:
                    return "打开打开";

                case Localizer.EditResourceIdentifiers.DEF_MENU_OPTIONS:
                    return "打开";

                case Localizer.EditResourceIdentifiers.DEF_MENU_PREVBOOKMARK:
                    return "上一个书签";

                case Localizer.EditResourceIdentifiers.DEF_MENU_PRINT:
                    return "打印";

                case Localizer.EditResourceIdentifiers.DEF_MENU_PRINTPREVIEW:
                    return "打印预览";

                case Localizer.EditResourceIdentifiers.DEF_MENU_REDO:
                    return "重做";

                case Localizer.EditResourceIdentifiers.DEF_MENU_REPLACE:
                    return "更换";

                case Localizer.EditResourceIdentifiers.DEF_MENU_SAVE:
                    return "保存";

                case Localizer.EditResourceIdentifiers.DEF_MENU_SAVEAS:
                    return "另存为";

                case Localizer.EditResourceIdentifiers.DEF_MENU_SELECTALL:
                    return "全选";

                case Localizer.EditResourceIdentifiers.DEF_MENU_TABIFYSELECTION:
                    return "主题";

                case Localizer.EditResourceIdentifiers.DEF_MENU_TOGGLEBOOKMARK:
                    return "切换书签";

                case Localizer.EditResourceIdentifiers.DEF_MENU_UNCOMMENTSELECTION:
                    return "取消注释选择";

                case Localizer.EditResourceIdentifiers.DEF_MENU_UNDO:
                    return "解开";

                case Localizer.EditResourceIdentifiers.DEF_MENU_UNTABIFYSELECTION:
                    return "未选择";

                case Localizer.EditResourceIdentifiers.DEF_MENU_UNINDENTSELECTION:
                    return "取消缩进";

                case Localizer.EditResourceIdentifiers.DEF_MENU_ADVANCED:
                    return "高级";
      }

}
Public Function GetLocalizedString(ByVal culture AsSystem.Globalization.CultureInfo, ByVal name As String, ByVal obj As Object) AsString

      Select Case name

               Case Localizer.EditResourceIdentifiers.DEF_MENU_BOOKMARKS
                    Return "上下文菜单书签"

                Case Localizer.EditResourceIdentifiers.DEF_MENU_CLEARBOOKMARKS
                    Return "清除书签"

                Case Localizer.EditResourceIdentifiers.DEF_MENU_CLOSE
                    Return "上下文菜单关"

                Case Localizer.EditResourceIdentifiers.DEF_MENU_COLLAPSEALL
                    Return "上下文菜单坍方"

                Case Localizer.EditResourceIdentifiers.DEF_MENU_COMMENTSELECTION
                    Return "上下文菜单评论选择"

                Case Localizer.EditResourceIdentifiers.DEF_MENU_COPY
                    Return "上文菜单评论"

                Case Localizer.EditResourceIdentifiers.DEF_MENU_CUT
                    Return "切"

                Case Localizer.EditResourceIdentifiers.DEF_MENU_DELETE
                    Return "删除"

                Case Localizer.EditResourceIdentifiers.DEF_MENU_DELETEALL
                    Return "删除所有"

                Case Localizer.EditResourceIdentifiers.DEF_MENU_EDIT
                    Return "编辑"

                Case Localizer.EditResourceIdentifiers.DEF_MENU_FILE
                    Return "文件"
                    
                Case Localizer.EditResourceIdentifiers.DEF_MENU_EXPANDALL
                    Return "展开全部"

                Case Localizer.EditResourceIdentifiers.DEF_MENU_FIND
                    Return "找"

                Case Localizer.EditResourceIdentifiers.DEF_MENU_GOTO
                    Return "去"

                Case Localizer.EditResourceIdentifiers.DEF_MENU_INDENTSELECTION
                    Return "缩进选择"

                Case Localizer.EditResourceIdentifiers.DEF_MENU_NEW
                    Return "新"

                Case Localizer.EditResourceIdentifiers.DEF_MENU_OPEN
                    Return "打开打开"

                Case Localizer.EditResourceIdentifiers.DEF_MENU_OPTIONS
                    Return "打开"

                Case Localizer.EditResourceIdentifiers.DEF_MENU_PREVBOOKMARK
                    Return "上一个书签"

                Case Localizer.EditResourceIdentifiers.DEF_MENU_PRINT
                    Return "打印"

                Case Localizer.EditResourceIdentifiers.DEF_MENU_PRINTPREVIEW
                    Return "打印预览"

                Case Localizer.EditResourceIdentifiers.DEF_MENU_REDO
                    Return "重做"

                case Localizer.EditResourceIdentifiers.DEF_MENU_REPLACE
                    Return "更换"

                Case Localizer.EditResourceIdentifiers.DEF_MENU_SAVE
                    Return "保存"

                Case Localizer.EditResourceIdentifiers.DEF_MENU_SAVEAS
                    Return "另存为"

                Case Localizer.EditResourceIdentifiers.DEF_MENU_SELECTALL
                    Return "全选"

                Case Localizer.EditResourceIdentifiers.DEF_MENU_TABIFYSELECTION
                    Return "主题"

                Case Localizer.EditResourceIdentifiers.DEF_MENU_TOGGLEBOOKMARK
                    Return "切换书签"

                Case Localizer.EditResourceIdentifiers.DEF_MENU_UNCOMMENTSELECTION
                    Return "取消注释选择"

                Case Localizer.EditResourceIdentifiers.DEF_MENU_UNDO
                    Return "解开"

                Case Localizer.EditResourceIdentifiers.DEF_MENU_UNTABIFYSELECTION
                    Return "未选择"

                Case Localizer.EditResourceIdentifiers.DEF_MENU_UNINDENTSELECTION
                    Return "取消缩进"

                Case Localizer.EditResourceIdentifiers.DEF_MENU_ADVANCED
                    Return "高级"


      End Select

End Function

Localized context menu in syntax editor

NOTE

Refer to the following sample link that demonstrates the localization support in EditControl:
C:\Users\<User>\AppData\Local\Syncfusion\EssentialStudio\Version Number\Windows\Edit.Windows\Samples\Localization