Controls / PdfViewer

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

Localization

To localize RadPdfViewer to display any text and messages in a specific language:

  • Create a custom PdfViewerLocalizationProvider 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:

RadPdfViewer Localization

public class MyLocalizationProvider : PdfViewerLocalizationProvider
{
    public override string GetLocalizedString(string id)
    {
        switch (id)
        {
            case PdfViewerStringId.ContextMenuCopy:
                return "&Copy";
            case PdfViewerStringId.ContextMenuSelectAll:
                return "Select &All";
            case PdfViewerStringId.ContextMenuDeselectAll:
                return "&Deselect All";
            case PdfViewerStringId.ContextMenuHand:
                return "&Hand";
            case PdfViewerStringId.ContextMenuSelection:
                return "&Selection";
            case PdfViewerStringId.ContextMenuPreviousPage:
                return "&Previous Page";
            case PdfViewerStringId.ContextMenuNextPage:
                return "&Next Page";
            case PdfViewerStringId.ContextMenuPrint:
                return "P&rint...";
            case PdfViewerStringId.ContextMenuFind:
                return "&Find Next";
            case PdfViewerStringId.NavigatorOpenButton:
                return "Open";
            case PdfViewerStringId.NavigatorPrintButton:
                return "Print";
            case PdfViewerStringId.RotateCounterclockwiseButton:
                return "Rotate Counterclockwise";
            case PdfViewerStringId.RotateClockwiseButton:
                return "Rotate Clockwise";
            case PdfViewerStringId.NavigatorPreviousPageButton:
                return "Previous page";
            case PdfViewerStringId.NavigatorNextPageButton:
                return "Next page";
            case PdfViewerStringId.NavigatorCurrentPageTextBox:
                return "Current page";
            case PdfViewerStringId.NavigatorTotalPagesLabel:
                return "Total pages";
            case PdfViewerStringId.NavigatorZoomInButton:
                return "Zoom in";
            case PdfViewerStringId.NavigatorZoomOutButton:
                return "Zoom out";
            case PdfViewerStringId.NavigatorZoomDropDown:
                return "Zoom drop-down";
            case PdfViewerStringId.NavigatorHandToolButton:
                return "Pan";
            case PdfViewerStringId.NavigatorSelectToolButton:
                return "Selection";
            case PdfViewerStringId.NavigatorFindNextButton:
                return "Find next";
            case PdfViewerStringId.NavigatorFindPreviousButton:
                return "Find previous";
            case PdfViewerStringId.NavigatorSearchTextBox:
                return "Search";
            case PdfViewerStringId.NavigatorNoResultMessage:
                return "No results found according to the specified criteria.";
            case PdfViewerStringId.NavigatorNoResultMessageHeader:
                return "Information";
            case PdfViewerStringId.NavigatorDefaultStrip:
                return "Default strip";
            case PdfViewerStringId.PrintPreviewGroupBoxPreview:
                return "Preview";
            case PdfViewerStringId.PrintPreviewGroupBoxOrientation:
                return "Orientation";
            case PdfViewerStringId.PrintPreviewGroupBoxSettings:
                return "Settings";
            case PdfViewerStringId.PrintPreviewButtonPrint:
                return "Print";
            case PdfViewerStringId.PrintPreviewButtonCancel:
                return "Cancel";
            case PdfViewerStringId.PrintPreviewButtonWatermark:
                return "Watermark";
            case PdfViewerStringId.PrintPreviewButtonSettings:
                return "Print Settings";
            case PdfViewerStringId.PrintPreviewLabelPageSizeInches:
                return "{0:F2} x {1:F2} Inches";
            case PdfViewerStringId.PrintPreviewLabelPageSizeCm:
                return "{0:F2}cm x {1:F2}cm";
            case PdfViewerStringId.PrintPreviewLabelScale:
                return "Scale: {0}%";
            case PdfViewerStringId.PrintPreviewLabelCurrentPage:
                return "Page {0} of {1}";
            case PdfViewerStringId.PrintPreviewFormTitle:
                return "Print Preview";
            case PdfViewerStringId.PrintPreviewPrintError:
                return "Error printing the document!";
            case PdfViewerStringId.PrintPreviewRadioPortrait:
                return "Portrait";
            case PdfViewerStringId.PrintPreviewRadioLandscape:
                return "Landscape";
            case PdfViewerStringId.PrintPreviewRadioAuto:
                return "Auto";
            case PdfViewerStringId.NavigatorFitToWidthButton:
                return "Fit To Width";
            case PdfViewerStringId.NavigatorFitToPageButton:
                return "Fit Full Page";
            case PdfViewerStringId.PageThumbnailsLabel:
                return "Page Thumbnails";
            case PdfViewerStringId.SaveButton:
                return "Save As";
            case PdfViewerStringId.CloseButton:
                return "Close";
            case PdfViewerStringId.NavigatorShowSignatureButton:
                return "Signature Panel";
            case PdfViewerStringId.SignatureDialogTitle:
                return "Signature Validation Status";
            case PdfViewerStringId.SignaturePanel_Invalid:
                return "At least one signature is invalid.";
            case PdfViewerStringId.SignaturePanel_Unknown:
                return "At least one signature has problems.";
            case PdfViewerStringId.SignaturePanel_Valid:
                return "Signed and all signatures are valid.";
            case PdfViewerStringId.SignaturePropertiesDialogHeader:
                return "Signature Validation Status";
            case PdfViewerStringId.SignaturePropertiesDialogViewModel_IsDocumentModified_False:
                return "The document is not modified since this signature was applied.";
            case PdfViewerStringId.SignaturePropertiesDialogViewModel_IsDocumentModified_True:
                return "The document has been altered or corrupted since the Signature was applied.";
            case PdfViewerStringId.SignaturePropertiesDialogViewModel_SignatureIsInvalid:
                return "Signature is Invalid.";
            case PdfViewerStringId.SignaturePropertiesDialogViewModel_SignatureIsUnknown:
                return "Signature validity is Unknown.";
            case PdfViewerStringId.SignaturePropertiesDialogViewModel_SignatureIsValid:
                return "Signature is Valid, signed by ";
            case PdfViewerStringId.SignaturePropertiesDialogViewModel_SignerValidity_Unknown:
                return "The signer's identity is unknown.";
            case PdfViewerStringId.SignaturePropertiesDialogViewModel_SignerValidity_UntrustedRoot:
                return "The signer's identity is unknown because it has not been included in your list of trusted certificates and none of its parent certificates are trusted.";
            case PdfViewerStringId.SignaturePropertiesDialogViewModel_SignerValidity_Valid:
                return "The signer's identity is valid.";
            case PdfViewerStringId.SelectCertButton:
                return "Select";
            case PdfViewerStringId.SignButton:
                return "Sign";
            case PdfViewerStringId.EnterAPassTextBox:
                return "Enter a password";
            case PdfViewerStringId.SelectCertTextBox:
                return "Select certificate";
        }
        return base.GetLocalizedString(id);
    }
}

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

Changing the Localization Provider

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