Localization
To localize RadDock 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 RadDockLocalizationProvider 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 in English:
Localizing RadDock Strings
public class EnglishDockLocalizationProvider : RadDockLocalizationProvider
{
public override string GetLocalizedString(string id)
{
switch (id)
{
case RadDockStringId.ContextMenuFloating:
return "Floating";
case RadDockStringId.ContextMenuDockable:
return "Dockable";
case RadDockStringId.ContextMenuTabbedDocument:
return "Tabbed Document";
case RadDockStringId.ContextMenuAutoHide:
return "Auto Hide";
case RadDockStringId.ContextMenuHide:
return "Hide";
case RadDockStringId.ContextMenuClose:
return "Close";
case RadDockStringId.ContextMenuCloseAll:
return "Close All";
case RadDockStringId.ContextMenuCloseAllButThis:
return "Close All But This";
case RadDockStringId.ContextMenuMoveToPreviousTabGroup:
return "Move to Previous Tab Group";
case RadDockStringId.ContextMenuMoveToNextTabGroup:
return "Move to Next Tab Group";
case RadDockStringId.ContextMenuNewHorizontalTabGroup:
return "New Horizontal Tab Group";
case RadDockStringId.ContextMenuNewVerticalTabGroup:
return "New Vertical Tab Group";
case RadDockStringId.ToolTabStripCloseButton:
return "Close Window";
case RadDockStringId.ToolTabStripDockStateButton:
return "Window State";
case RadDockStringId.ToolTabStripUnpinButton:
return "Auto Hide";
case RadDockStringId.ToolTabStripPinButton:
return "Docked";
case RadDockStringId.DocumentTabStripCloseButton:
return "Close Document";
case RadDockStringId.DocumentTabStripListButton:
return "Active Documents";
case RadDockStringId.ContextMenuCloseAllButPinned:
return "Close All but Pinned";
}
return string.Empty;
}
}To apply the custom localization provider, instantiate and assign it to the current localization provider:
Localizing RadDock Strings
RadDockLocalizationProvider.CurrentProvider = new EnglishDockLocalizationProvider();The code provided above illustrates the approach to be used to localize the RadDock and is not intended as a full translation.