Controls / File Dialogs

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

Localization

To localize RadFileDialogs 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 FileDialogsLocalizationProvider 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 File Dialogs

        public class MyFileDialogsLocalizationProvider : FileDialogsLocalizationProvider
        {
            public override string GetLocalizedString(string id)
            {
                switch (id)
                {
                    case FileDialogsStringId.OK:
                        return "OK";
                    case FileDialogsStringId.Yes:
                        return "Yes";
                    case FileDialogsStringId.No:
                        return "No";
                    case FileDialogsStringId.Cancel:
                        return "Cancel";

                    case FileDialogsStringId.Back:
                        return "Back";
                    case FileDialogsStringId.Forward:
                        return "Forward";
                    case FileDialogsStringId.Up:
                        return "Up";
                    case FileDialogsStringId.NewFolder:
                        return "New folder";
                    case FileDialogsStringId.SearchIn:
                        return "Search in";
                    case FileDialogsStringId.SearchResults:
                        return "Search results in";

                    case FileDialogsStringId.ExtraLargeIcons:
                        return "Extra large icons";
                    case FileDialogsStringId.LargeIcons:
                        return "Large icons";
                    case FileDialogsStringId.MediumIcons:
                        return "Medium icons";
                    case FileDialogsStringId.SmallIcons:
                        return "Small icons";
                    case FileDialogsStringId.List:
                        return "List";
                    case FileDialogsStringId.Tiles:
                        return "Tiles";
                    case FileDialogsStringId.Details:
                        return "Details";

                    case FileDialogsStringId.NameHeader:
                        return "Name";
                    case FileDialogsStringId.SizeHeader:
                        return "Size";
                    case FileDialogsStringId.TypeHeader:
                        return "Type";
                    case FileDialogsStringId.DateHeader:
                        return "Date modified";

                    case FileDialogsStringId.FileSizes_B:
                        return "bytes";
                    case FileDialogsStringId.FileSizes_GB:
                        return "GB";
                    case FileDialogsStringId.FileSizes_KB:
                        return "KB";
                    case FileDialogsStringId.FileSizes_MB:
                        return "MB";
                    case FileDialogsStringId.FileSizes_TB:
                        return "TB";

                    case FileDialogsStringId.OpenFileDialogHeader:
                        return "Open File";
                    case FileDialogsStringId.OpenFolderDialogHeader:
                        return "Open Folder";
                    case FileDialogsStringId.SaveFileDialogHeader:
                        return "Save As";

                    case FileDialogsStringId.FileName:
                        return "File name:";
                    case FileDialogsStringId.Folder:
                        return "Folder:";
                    case FileDialogsStringId.SaveAsType:
                        return "Save as type:";

                    case FileDialogsStringId.OpenFolder:
                        return "Open Folder";
                    case FileDialogsStringId.FileFolderType:
                        return "File folder";

                    case FileDialogsStringId.Cut:
                        return "Cut";
                    case FileDialogsStringId.Copy:
                        return "Copy";
                    case FileDialogsStringId.CopyTo:
                        return "Copy to";
                    case FileDialogsStringId.Delete:
                        return "Delete";
                    case FileDialogsStringId.Edit:
                        return "Edit";
                    case FileDialogsStringId.MoveTo:
                        return "Move to";
                    case FileDialogsStringId.Open:
                        return "Open";
                    case FileDialogsStringId.Paste:
                        return "Paste";
                    case FileDialogsStringId.Properties:
                        return "Properties";
                    case FileDialogsStringId.Rename:
                        return "Rename";
                    case FileDialogsStringId.Save:
                        return "Save";
                    case FileDialogsStringId.View:
                        return "View";

                    case FileDialogsStringId.CheckThePath:
                        return "Check the path and try again.";
                    case FileDialogsStringId.ConfirmSave:
                        return "Confirm save as";
                    case FileDialogsStringId.FileExists:
                        return "already exists.";
                    case FileDialogsStringId.FileNameWrongCharacters:
                        return "A file name can't contain any of the following characters: \\ / : * ? \" < > |";
                    case FileDialogsStringId.InvalidExtensionConfirmation:
                        return "Are you sure you want to change it?";
                    case FileDialogsStringId.InvalidFileName:
                        return "The file name is not valid.";
                    case FileDialogsStringId.InvalidOrMissingExtension:
                        return "If you change a file name extension, the file might become unusable.";
                    case FileDialogsStringId.InvalidPath:
                        return "Path does not exist.";
                    case FileDialogsStringId.OpenReadOnly:
                        return "Open as read-only";
                    case FileDialogsStringId.ReplacementQuestion:
                        return "Do you want to replace it?";

                    default:
                        return string.Empty;
                }
            }
        }

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

Assigning the Current Localization Provider

FileDialogsLocalizationProvider.CurrentProvider = new MyFileDialogsLocalizationProvider();
In this article
Related articles
Not finding the help you need? Improve this article