New to Telerik UI for WinFormsStart a free 30-day trial

Localization

Updated on May 7, 2026

To localize RadImageEditor to display control 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 ImageEditorLocalizationProvider 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 of the base GetLocalizedString method in the default clause of the switch statement in the example.

Below is a sample implementation of an English localization provider:

Localizing RadImageEditor Strings

C#
public class MyImageEditorLocalizationProvider : ImageEditorLocalizationProvider
{
    public override string GetLocalizedString(string id)
    {
        switch (id)
        {
            case ImageEditorStringId.OpenCommandTooltip: return "Open Image";
            case ImageEditorStringId.SaveCommandTooltip: return "Save Image";
            case ImageEditorStringId.UndoCommandTooltip: return "Undo";
            case ImageEditorStringId.RedoCommandTooltip: return "Redo";

            case ImageEditorStringId.ResizeDialogTitle: return "Resize";
            case ImageEditorStringId.ResizeDialogImageSize: return "Image Size (px)";
            case ImageEditorStringId.ResizeDialogWidth: return "Width";
            case ImageEditorStringId.ResizeDialogHeight: return "Height";
            case ImageEditorStringId.ResizeDialogRelativeSize: return "Relative Size (%)";
            case ImageEditorStringId.ResizeDialogRelativeWidth: return "Width";
            case ImageEditorStringId.ResizeDialogRelativeHeight: return "Height";
            case ImageEditorStringId.ResizeDialogPreserveAspectRatio: return "Preserve Aspect Ratio";
            case ImageEditorStringId.ResizeDialogReset: return "Reset";

            case ImageEditorStringId.CanvasResizeDialogTitle: return "Resize Canvas";
            case ImageEditorStringId.CanvasResizeDialogCanvasSize: return "Canvas Size";
            case ImageEditorStringId.CanvasResizeDialogWidth: return "Width";
            case ImageEditorStringId.CanvasResizeDialogHeight: return "Height";
            case ImageEditorStringId.CanvasResizeDialogImageAlignment: return "Image Alignment";
            case ImageEditorStringId.CanvasResizeDialogBackground: return "Background";
            case ImageEditorStringId.CanvasResizeDialogReset: return "Reset";

            case ImageEditorStringId.RoundCornersDialogTitle: return "Round Corners";
            case ImageEditorStringId.RoundCornersDialogRadius: return "Radius";
            case ImageEditorStringId.RoundCornersDialogBackground: return "Background";
            case ImageEditorStringId.RoundCornersDialogBorderThickness: return "Border Thickness";
            case ImageEditorStringId.RoundCornersDialogBorderColor: return "Border Color";
            case ImageEditorStringId.RoundCornersDialogReset: return "Reset";

            case ImageEditorStringId.CropAccept: return "Accept";
            case ImageEditorStringId.CropCancel: return "Cancel";

            case ImageEditorStringId.DrawTextDialogTitle: return "Draw Text";
            case ImageEditorStringId.DrawTextDialogText: return "Text";
            case ImageEditorStringId.DrawTextDialogYourTextHere: return "Your Text Here...";
            case ImageEditorStringId.DrawTextDialogFontSize: return "Font Size";
            case ImageEditorStringId.DrawTextDialogTextColort: return "Text Colort";
            case ImageEditorStringId.DrawTextDialogHorizontalPosition: return "Horizontal Position";
            case ImageEditorStringId.DrawTextDialogVerticalPosition: return "Vertical Position";
            case ImageEditorStringId.DrawTextDialogRotation: return "Rotation";
            case ImageEditorStringId.DrawTextDialogReset: return "Reset";

            case ImageEditorStringId.DrawDialogTitle: return "Draw";
            case ImageEditorStringId.DrawDialogBrushSize: return "Brush Size";
            case ImageEditorStringId.DrawDialogBrushColor: return "Brush Color";

            case ImageEditorStringId.DrawShapeDialogTitle: return "Draw Shape";
            case ImageEditorStringId.DrawShapeDialogShape: return "Shape";
            case ImageEditorStringId.DrawShapeDialogShapeFill: return "Shape Fill";
            case ImageEditorStringId.DrawShapeDialogBorderThickness: return "Border Thickness";
            case ImageEditorStringId.DrawShapeDialogBorderColor: return "Border Color";

            case ImageEditorStringId.ShapeTypeRectangle: return "Rectangle";
            case ImageEditorStringId.ShapeTypeSquare: return "Square";
            case ImageEditorStringId.ShapeTypeEllipse: return "Ellipse";
            case ImageEditorStringId.ShapeTypeCircle: return "Circle";
            case ImageEditorStringId.ShapeTypeLine: return "Line";
            case ImageEditorStringId.ShapeTypeFreeflow: return "Freeflow";

            case ImageEditorStringId.HueDialogTitle: return "Hue";
            case ImageEditorStringId.HueDialogHueShift: return "Hue Shift";
            case ImageEditorStringId.HueDialogReset: return "Reset";

            case ImageEditorStringId.SaturationDialogTitle: return "Saturation";
            case ImageEditorStringId.SaturationDialogSaturation: return "Saturation";
            case ImageEditorStringId.SaturationDialogReset: return "Reset";

            case ImageEditorStringId.ContrastAndBrightnessDialogTitle: return "Contrast & Brightness";
            case ImageEditorStringId.ContrastAndBrightnessDialogBrightness: return "Brightness";
            case ImageEditorStringId.ContrastAndBrightnessDialogContrast: return "Contrast";
            case ImageEditorStringId.ContrastAndBrightnessDialogReset: return "Reset";

            case ImageEditorStringId.SharpenDialogTitle: return "Sharpen";
            case ImageEditorStringId.SharpenDialogAmount: return "Amount";
            case ImageEditorStringId.SharpenDialogReset: return "Reset";

            case ImageEditorStringId.BlurDialogTitle: return "Blur";
            case ImageEditorStringId.BlurDialogAmount: return "Amount";
            case ImageEditorStringId.BlurDialogReset: return "Reset";

            case ImageEditorStringId.ZoomFactorAuto: return "Auto";

            case ImageEditorStringId.CommandsTransform: return "Transform";
            case ImageEditorStringId.CommandsResize: return "Resize";
            case ImageEditorStringId.CommandsCanvasResize: return "Canvas Resize";
            case ImageEditorStringId.CommandsRotate90: return "Rotate 90";
            case ImageEditorStringId.CommandsRotate180: return "Rotate 180";
            case ImageEditorStringId.CommandsRotate270: return "Rotate 270";
            case ImageEditorStringId.CommandsRoundCorners: return "Round Corners";
            case ImageEditorStringId.CommandsFlipHorizontal: return "Flip Horizontal";
            case ImageEditorStringId.CommandsFlipVertical: return "Flip Vertical";
            case ImageEditorStringId.CommandsCrop: return "Crop";
            case ImageEditorStringId.CommandsDrawText: return "Draw Text";
            case ImageEditorStringId.CommandsDraw: return "Draw";
            case ImageEditorStringId.CommandsDrawShape: return "Draw Shape";
            case ImageEditorStringId.CommandsPan: return "Pan";
            case ImageEditorStringId.CommandsAdjust: return "Adjust";
            case ImageEditorStringId.CommandsHue: return "Hue";
            case ImageEditorStringId.CommandsSaturation: return "Saturation";
            case ImageEditorStringId.CommandsContrast: return "Contrast";
            case ImageEditorStringId.CommandsInvertColors: return "InvertColors";
            case ImageEditorStringId.CommandsEffects: return "Effects";
            case ImageEditorStringId.CommandsSharpen: return "Sharpen";
            case ImageEditorStringId.CommandsBlur: return "Blur";

            default: return base.GetLocalizedString(id);
        }
    }
}

Assigning the Current Localization Provider

C#
ImageEditorLocalizationProvider.CurrentProvider = new MyImageEditorLocalizationProvider();

See Also

In this article
See Also
Not finding the help you need?
Contact Support