New to Telerik UI for WinForms? Download free 30-day trial

Localization

To localize RadColorDialog form to display text and messages in a specific language:

  • All required classes for localization are defined in Telerik.WinControls.UI.Localization namespace.
  • Start by creating a descendant of the ColorDialogLocalizationProvider class.
  • Override the GetLocalizedString(string id) method and provide a translation for the label and user messages. If a translation is not provided, the default value will be returned. This behavior is guaranteed by the call to the base GetLocalizedString method in the default clause of the switch statement in the example.

Below is a sample implementation of a custom localization provider, which returns translations of the default values:

Localizing RadColorDialog strings

public class CustomColorDialogLocalizationProvider : ColorDialogLocalizationProvider
{
    public override string GetLocalizedString(string id)
    {
        switch (id)
        {
            //localizing the static strings
            case ColorDialogStringId.ColorDialogProfessionalTab: return "Localized Professional";
            case ColorDialogStringId.ColorDialogWebTab: return "Localized Web";
            case ColorDialogStringId.ColorDialogSystemTab: return "Localized System";
            case ColorDialogStringId.ColorDialogBasicTab: return "Localized Basic";
            case ColorDialogStringId.ColorDialogAddCustomColorButton: return "Localized Add Custom Color";
            case ColorDialogStringId.ColorDialogOKButton: return "Localized OK";
            case ColorDialogStringId.ColorDialogCancelButton: return "Localized Cancel";
            case ColorDialogStringId.ColorDialogNewColorLabel: return "Localized New";
            case ColorDialogStringId.ColorDialogCurrentColorLabel: return "Localized Current";
            case ColorDialogStringId.ColorDialogCaption: return "Localized Color dialog";
            //you can also localize the names of the colors
            case "Black": return "Localized Black";
            case "Blue": return "Localized Blue";
            case "Aqua": return "Localized Aqua";
        }
        return base.GetLocalizedString(id);
    }
}

Public Class CustomColorDialogLocalizationProvider
    Inherits ColorDialogLocalizationProvider
    Public Overrides Function GetLocalizedString(id As String) As String
        Select Case id
            'localizing the static strings
            Case ColorDialogStringId.ColorDialogProfessionalTab
                Return "Localized Professional"
            Case ColorDialogStringId.ColorDialogWebTab
                Return "Localized Web"
            Case ColorDialogStringId.ColorDialogSystemTab
                Return "Localized System"
            Case ColorDialogStringId.ColorDialogBasicTab
                Return "Localized Basic"
            Case ColorDialogStringId.ColorDialogAddCustomColorButton
                Return "Localized Add Custom Color"
            Case ColorDialogStringId.ColorDialogOKButton
                Return "Localized OK"
            Case ColorDialogStringId.ColorDialogCancelButton
                Return "Localized Cancel"
            Case ColorDialogStringId.ColorDialogNewColorLabel
                Return "Localized New"
            Case ColorDialogStringId.ColorDialogCurrentColorLabel
                Return "Localized Current"
            Case ColorDialogStringId.ColorDialogCaption
                Return "Localized Color dialog"
                'you can also localize the names of the colors
            Case "Black"
                Return "Localized Black"
            Case "Blue"
                Return "Localized Blue"
            Case "Aqua"
                Return "Localized Aqua"
        End Select
        Return MyBase.GetLocalizedString(id)
    End Function
End Class

To apply the custom localization provider, instantiate and assign it to the current localization provider:

Using the custom localization provider

ColorDialogLocalizationProvider.CurrentProvider = new CustomColorDialogLocalizationProvider();

ColorDialogLocalizationProvider.CurrentProvider = New CustomColorDialogLocalizationProvider()

The code provided above illustrates the approach to be used to localize the RadColorDialog and is not intended as a full translation.

In this article