New to Telerik UI for WinForms? Start a free 30-day trial
Localize print dialogs
Updated over 1 year ago
To localize the print dialogs to display text and messages in a specific language:
-
All required classes for localization are defined in Telerik.WinControls.UI.Localization namespace.
-
All print settings dialogs display measurements in imperial or metric units depending on the current system regional info. You only have to take care for the string representation of the units.
-
Start by creating a descendant of the PrintDialogsLocalizationProvider 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 an English localization provider:
Localizing print dialogs
C#
class MyPrintDialogsLocalizationProvider : Telerik.WinControls.UI.PrintDialogsLocalizationProvider
{
public override string GetLocalizedString(string id)
{
switch (id)
{
case PrintDialogsStringId.PreviewDialogTitle: return "Print Preview";
case PrintDialogsStringId.PreviewDialogPrint: return "Print...";
case PrintDialogsStringId.PreviewDialogPrintSettings: return "Print Settings...";
case PrintDialogsStringId.PreviewDialogWatermark: return "Watermark...";
case PrintDialogsStringId.PreviewDialogPreviousPage: return "Previous Page";
case PrintDialogsStringId.PreviewDialogNextPage: return "Next Page";
case PrintDialogsStringId.PreviewDialogZoomIn: return "Zoom In";
case PrintDialogsStringId.PreviewDialogZoomOut: return "Zoom Out";
case PrintDialogsStringId.PreviewDialogZoom: return "Zoom";
case PrintDialogsStringId.PreviewDialogAuto: return "Auto";
case PrintDialogsStringId.PreviewDialogLayout: return "Layout";
case PrintDialogsStringId.PreviewDialogFile: return "File";
case PrintDialogsStringId.PreviewDialogView: return "View";
case PrintDialogsStringId.PreviewDialogTools: return "Tools";
case PrintDialogsStringId.PreviewDialogExit: return "Exit";
case PrintDialogsStringId.PreviewDialogStripTools: return "Tools";
case PrintDialogsStringId.PreviewDialogStripNavigation: return "Navigation";
case PrintDialogsStringId.WatermarkDialogTitle: return "Watermark Settings";
case PrintDialogsStringId.WatermarkDialogButtonOK: return "OK";
case PrintDialogsStringId.WatermarkDialogButtonCancel: return "Cancel";
case PrintDialogsStringId.WatermarkDialogLabelPreview: return "Preview";
case PrintDialogsStringId.WatermarkDialogButtonRemove: return "Remove watermark";
case PrintDialogsStringId.WatermarkDialogLabelPosition: return "Position";
case PrintDialogsStringId.WatermarkDialogRadioInFront: return "In Front";
case PrintDialogsStringId.WatermarkDialogRadioBehind: return "Behind";
case PrintDialogsStringId.WatermarkDialogLabelPageRange: return "Page range";
case PrintDialogsStringId.WatermarkDialogRadioAll: return "All";
case PrintDialogsStringId.WatermarkDialogRadioPages: return "Pages";
case PrintDialogsStringId.WatermarkDialogLabelPagesDescription: return "(e.g. 1,3,5-12)";
case PrintDialogsStringId.WatermarkDialogTabText: return "Text";
case PrintDialogsStringId.WatermarkDialogTabPicture: return "Picture";
case PrintDialogsStringId.WatermarkDialogLabelText: return "Text";
case PrintDialogsStringId.WatermarkDialogWatermarkText: return "Watermark text";
case PrintDialogsStringId.WatermarkDialogLabelHOffset: return "Horizontal offset";
case PrintDialogsStringId.WatermarkDialogLabelVOffset: return "Vertical offset";
case PrintDialogsStringId.WatermarkDialogLabelRotation: return "Rotation";
case PrintDialogsStringId.WatermarkDialogLabelFont: return "Font:";
case PrintDialogsStringId.WatermarkDialogLabelSize: return "Size:";
case PrintDialogsStringId.WatermarkDialogLabelColor: return "Color:";
case PrintDialogsStringId.WatermarkDialogLabelOpacity: return "Opacity:";
case PrintDialogsStringId.WatermarkDialogLabelLoadImage: return "Load image:";
case PrintDialogsStringId.WatermarkDialogCheckboxTiling: return "Tiling";
case PrintDialogsStringId.SettingDialogTitle: return "Print Settings";
case PrintDialogsStringId.SettingDialogButtonPrint: return "Print";
case PrintDialogsStringId.SettingDialogButtonPreview: return "Preview";
case PrintDialogsStringId.SettingDialogButtonCancel: return "Cancel";
case PrintDialogsStringId.SettingDialogButtonOK: return "OK";
case PrintDialogsStringId.SettingDialogPageFormat: return "Format";
case PrintDialogsStringId.SettingDialogPagePaper: return "Paper";
case PrintDialogsStringId.SettingDialogPageHeaderFooter: return "Header/Footer";
case PrintDialogsStringId.SettingDialogButtonPageNumber: return "Page Number";
case PrintDialogsStringId.SettingDialogButtonTotalPages: return "Total Pages";
case PrintDialogsStringId.SettingDialogButtonCurrentDate: return "Current Date";
case PrintDialogsStringId.SettingDialogButtonCurrentTime: return "Current Time";
case PrintDialogsStringId.SettingDialogButtonUserName: return "User Name";
case PrintDialogsStringId.SettingDialogLabelHeader: return "Header";
case PrintDialogsStringId.SettingDialogLabelFooter: return "Footer";
case PrintDialogsStringId.SettingDialogCheckboxReverse: return "Reverse on even pages";
case PrintDialogsStringId.SettingDialogLabelPage: return "Page";
case PrintDialogsStringId.SettingDialogLabelType: return "Type";
case PrintDialogsStringId.SettingDialogLabelPageSource: return "Page source";
case PrintDialogsStringId.SettingDialogLabelMargins: return "Margins (inches)";
case PrintDialogsStringId.SettingDialogLabelOrientation: return "Orientation";
case PrintDialogsStringId.SettingDialogLabelTop: return "Top:";
case PrintDialogsStringId.SettingDialogLabelBottom: return "Bottom:";
case PrintDialogsStringId.SettingDialogLabelLeft: return "Left:";
case PrintDialogsStringId.SettingDialogLabelRight: return "Right:";
case PrintDialogsStringId.SettingDialogRadioPortrait: return "Portrait";
case PrintDialogsStringId.SettingDialogRadioLandscape: return "Landscape";
case PrintDialogsStringId.SchedulerSettingsLabelPrintStyle: return "Print style";
case PrintDialogsStringId.SchedulerSettingsDailyStyle: return "Daily Style";
case PrintDialogsStringId.SchedulerSettingsWeeklyStyle: return "Weekly Style";
case PrintDialogsStringId.SchedulerSettingsMonthlyStyle: return "Monthly Style";
case PrintDialogsStringId.SchedulerSettingsDetailStyle: return "Details Style";
case PrintDialogsStringId.SchedulerSettingsButtonWatermark: return "Watermark...";
case PrintDialogsStringId.SchedulerSettingsLabelPrintRange: return "Print range";
case PrintDialogsStringId.SchedulerSettingsLabelStyleSettings: return "Style settings";
case PrintDialogsStringId.SchedulerSettingsLabelPrintSettings: return "Print settings";
case PrintDialogsStringId.SchedulerSettingsLabelStartDate: return "Start date";
case PrintDialogsStringId.SchedulerSettingsLabelEndDate: return "End date";
case PrintDialogsStringId.SchedulerSettingsLabelStartTime: return "Start time";
case PrintDialogsStringId.SchedulerSettingsLabelEndTime: return "End time";
case PrintDialogsStringId.SchedulerSettingsLabelDateFont: return "Date heading font";
case PrintDialogsStringId.SchedulerSettingsLabelAppointmentFont: return "Appointment font";
case PrintDialogsStringId.SchedulerSettingsLabelLayout: return "Layout";
case PrintDialogsStringId.SchedulerSettingsPrintPageTitle: return "Print page title";
case PrintDialogsStringId.SchedulerSettingsPrintCalendar: return "Include calendar in the title";
case PrintDialogsStringId.SchedulerSettingsPrintTimezone: return "Print the selected timezone";
case PrintDialogsStringId.SchedulerSettingsPrintNotesBlank: return "Notes area (blank)";
case PrintDialogsStringId.SchedulerSettingsPrintNotesLined: return "Notes area (lined)";
case PrintDialogsStringId.SchedulerSettingsNonworkingDays: return "Exclude non-working days";
case PrintDialogsStringId.SchedulerSettingsExactlyOneMonth: return "Print exactly one month";
case PrintDialogsStringId.SchedulerSettingsLabelWeeksPerPage: return "Weeks per page";
case PrintDialogsStringId.SchedulerSettingsNewPageEach: return "Start new page each";
case PrintDialogsStringId.SchedulerSettingsStringDay: return "Day";
case PrintDialogsStringId.SchedulerSettingsStringMonth: return "Month";
case PrintDialogsStringId.SchedulerSettingsStringWeek: return "Week";
case PrintDialogsStringId.SchedulerSettingsStringPage: return "Page";
case PrintDialogsStringId.SchedulerSettingsStringPages: return "Pages";
case PrintDialogsStringId.SchedulerSettingsLabelGroupBy: return "Group by:";
case PrintDialogsStringId.SchedulerSettingsGroupByNone: return "None";
case PrintDialogsStringId.SchedulerSettingsGroupByResource: return "Resource";
case PrintDialogsStringId.SchedulerSettingsGroupByDate: return "Date";
case PrintDialogsStringId.GridSettingsLabelPreview: return "Preview";
case PrintDialogsStringId.GridSettingsLabelStyleSettings: return "Style Settings";
case PrintDialogsStringId.GridSettingsLabelFitMode: return "Page fit mode:";
case PrintDialogsStringId.GridSettingsLabelHeaderCells: return "Header cells";
case PrintDialogsStringId.GridSettingsLabelGroupCells: return "Group cells";
case PrintDialogsStringId.GridSettingsLabelDataCells: return "Data cells";
case PrintDialogsStringId.GridSettingsLabelSummaryCells: return "Summary cells";
case PrintDialogsStringId.GridSettingsLabelBackground: return "Background";
case PrintDialogsStringId.GridSettingsLabelBorderColor: return "Border color";
case PrintDialogsStringId.GridSettingsLabelAlternatingRowColor: return "Alternating row color";
case PrintDialogsStringId.GridSettingsLabelPadding: return "Padding";
case PrintDialogsStringId.GridSettingsPrintGrouping: return "Print grouping";
case PrintDialogsStringId.GridSettingsPrintSummaries: return "Print summaries";
case PrintDialogsStringId.GridSettingsPrintHiddenRows: return "Print hidden rows";
case PrintDialogsStringId.GridSettingsPrintHiddenColumns: return "Print hidden columns";
case PrintDialogsStringId.GridSettingsPrintHeader: return "Print header on each page";
case PrintDialogsStringId.GridSettingsButtonWatermark: return "Watermark...";
case PrintDialogsStringId.GridSettingsFitPageWidth: return "FitPageWidth";
case PrintDialogsStringId.GridSettingsNoFit: return "NoFit";
case PrintDialogsStringId.GridSettingsNoFitCentered: return "NoFitCentered";
case PrintDialogsStringId.GridSettingsLabelPrint: return "Print";
}
return String.Empty;
}
}
To apply the custom localization provider, instantiate and assign it to the current localization provider:
Assigning the Current Localization Provider
C#
PrintDialogsLocalizationProvider.CurrentProvider = new MyPrintDialogsLocalizationProvider();
The code provided above illustrates the approach used to localize the print dialogs and is not intended as a full translation.