localization.md

title	Localization
page_title	Localization | RadRichTextEditor
description	RadRichTextEditor is a control that is able to display and edit rich-text content including formatted text arranged in pages, paragraphs, spans (runs), tables, etc.
slug	winforms/richtexteditor/localization
tags	localization
published	true
position	12
previous_url	richtexteditor-localization

Localization

To change the default English localization provider you should use the CurrentProvider static property of the RichTextBoxLocalizationProvider class. For example, you can load the string from a XML file like this:

{{source=..\SamplesCS\RichTextEditor\Localization.cs region=xml}} {{source=..\SamplesVB\RichTextEditor\Localization.vb region=xml}}

            
RichTextBoxLocalizationProvider.CurrentProvider = RichTextBoxLocalizationProvider.FromFile(@"C:\RichTextBoxStrings.xml");

RichTextBoxLocalizationProvider.CurrentProvider = RichTextBoxLocalizationProvider.FromFile("C:\RichTextBoxStrings.xml")

{{endregion}}

important You can download a XML file that contains all the currently used strings from here: Strings file

note As of R2 2015 RichTextBoxLocalizationProvider contains all strings related to the RadRichTextEditorRibbonUI as well.

Another approach is to create a custom localization provider class which inherits RichTextBoxLocalizationProvider. In it you should just override the GetLocalizedString method and return the localized string depending on current id.

{{source=..\SamplesCS\RichTextEditor\Localization.cs region=custom}} {{source=..\SamplesVB\RichTextEditor\Localization.vb region=custom}}

    
public class MyRichTextBoxLocalizationProvider : RichTextBoxLocalizationProvider
{
    public override string GetLocalizedString(string id)
    {
        switch (id)
        {
            case "Documents_FindReplaceDialog_FindNext":
                return "Weitersuchen";
            case "Documents_FindReplaceDialog_Header":
                return "Suchen und Ersetzen";
            case "Documents_FindReplaceDialog_Replace":
                return "Ersetzen";
            case "Documents_FindReplaceDialog_ReplaceAll":
                return "Alle ersetzen";
            case "Documents_FindReplaceDialog_ReplaceWith":
                return "Ersetzen durch";
            case "Documents_FindReplaceDialog_TextToFind":
                return "Suchen nach";
            case "Documents_FindReplaceDialog_RestartSearch":
                return "Zeigen unten die Multifunktionsleiste";
            case "Documents_FindReplaceDialog_SearchedTextNotFound":
                return "Der Suchbegriff wurde nicht gefunden";
            case "RibbonUI_BackstageButtonPrint":
                return "Druck";
        }
    
        return base.GetLocalizedString(id);
    }
}

Public Class MyRichTextBoxLocalizationProvider
    Inherits RichTextBoxLocalizationProvider
    Public Overrides Function GetLocalizedString(ByVal id As String) As String
        Select Case id
            Case "Documents_FindReplaceDialog_FindNext"
                Return "Weitersuchen"
            Case "Documents_FindReplaceDialog_Header"
                Return "Suchen und Ersetzen"
            Case "Documents_FindReplaceDialog_Replace"
                Return "Ersetzen"
            Case "Documents_FindReplaceDialog_ReplaceAll"
                Return "Alle ersetzen"
            Case "Documents_FindReplaceDialog_ReplaceWith"
                Return "Ersetzen durch"
            Case "Documents_FindReplaceDialog_TextToFind"
                Return "Suchen nach"
            Case "Documents_FindReplaceDialog_RestartSearch"
                Return "Zeigen unten die Multifunktionsleiste"
            Case "Documents_FindReplaceDialog_SearchedTextNotFound"
                Return "Der Suchbegriff wurde nicht gefunden"
            Case "RibbonUI_BackstageButtonPrint"
                Return "Druck"
        End Select
        Return MyBase.GetLocalizedString(id)
    End Function
End Class

{{endregion}}

The following code snippet shows how you can use the new class:

{{source=..\SamplesCS\RichTextEditor\Localization.cs region=change}} {{source=..\SamplesVB\RichTextEditor\Localization.vb region=change}}

            
RichTextBoxLocalizationProvider.CurrentProvider = new MyRichTextBoxLocalizationProvider();
            
InitializeComponent();

RichTextBoxLocalizationProvider.CurrentProvider = New MyRichTextBoxLocalizationProvider()
InitializeComponent()

{{endregion}}

note It is necessary to specify the RichTextBoxLocalizationProvider. CurrentProvider property before initializing the components.

caption Fig.1 RichTextBoxLocalizationProvider

caption Fig.2 Localize RadRichTextEditorRibbonUI