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);
    }
}

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

Using the custom localization provider

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