Named Actions
| Minimum Version | Q1 2025 |
|---|
RadPdfProcessing supports Named actions that PDF viewer applications are expected to support. The NamedAction class offers the public Type property that specifies the type of the action representing the menu item to execute.
The following table lists the available Standard NamedActionType options.
PDF viewer applications are expected to support the standard named actions. Additional names can be added, but not all PDF viewers support the NonStandard actions.
| Standard Named Actions | Description |
|---|---|
NextPage | Go to the next page of the document. |
PrevPage | Go to the previous page of the document. |
FirstPage | Go to the first page of the document. |
LastPage | Go to the last page of the document. |
Viewer applications may support additional, nonstandard named actions, but any document using them is not portable. If a viewer (for example, Adobe Acrobat, RadPdfViewer, or a web browser) encounters a named action that is inappropriate for a viewing platform, or if the viewer does not recognize the name, it takes no action.
RadPdfProcessing also supports the following NonStandard NamedAction types:
| NonStandard Named Actions | Description |
|---|---|
Print | Print the current document. |
SaveAs | Save the current document as a new file. |
Find | Find text within the document. |
FindSearch | Perform a search operation within the document. |
Close | Close the current document or viewer. |
GoToPage | Go to a specific page within the document. |
GoBack | Navigate back to the previous location. |
GoForward | Navigate forward to the next location. |
SinglePage | Display the document in single-page view mode. |
TwoPages | Display the document in two-page view mode. |
OneColumn | Display the document in one-column layout mode. |
ActualSize | Show the document at its actual size. |
FitPage | Fit the document page within the viewer. |
FitWidth | Fit the document width within the viewer. |
FitHeight | Fit the document height within the viewer. |
FitVisible | Fit the visible content of the page within the viewer. |
ZoomTo | Zoom to a specified level. |
FullScreenMode | Enter full-screen mode. |
ShowHideArticles | Show or hide articles within the document. |
ShowHideFileAttachment | Show or hide file attachments. |
ShowHideBookmarks | Show or hide bookmarks. |
ShowHideOptCont | Show or hide optional content. |
ShowHideModelTree | Show or hide the model tree. |
ShowHideThumbnails | Show or hide page thumbnails. |
ShowHideSignatures | Show or hide digital signatures. |
GeneralPrefs | Open general preferences for the viewer. |
GeneralInfo | Display general information about the document. |
Quit | Exit the viewer application. |
FindCurrentBookmark | Find the currently selected bookmark. |
BookmarkShowLocation | Show the location associated with a bookmark. |
ZoomViewIn | Zoom in the view. |
ZoomViewOut | Zoom out the view. |
HelpReader | Open the help documentation for the reader. |
TwoColumns | Display the document in two-column layout mode. |
HandMenuItem | Activate the hand tool menu item. |
ZoomDragMenuItem | Activate the zoom drag tool menu item. |
Scan | Initiate a scan operation. |
Adding a Named Action to a PushButtonField
The following example demonstrates how to create a PDF document with a PushButtonField that triggers a printing action when displayed in a viewer and the user presses the button:
PushButtonField pushButtonField = new PushButtonField("SamplePushButton");
PushButtonWidget widget = pushButtonField.Widgets.AddWidget();
widget.Rect = new Rect(10, 10, 250, 50);
widget.HighlightingMode = HighlightingMode.InvertBorderOfAnnotationRectangle;
NamedAction printAction = new NamedAction(NamedActionType.Print);
widget.Actions.MouseUp.Add(printAction);
widget.AppearanceCharacteristics.Background = new RgbColor(123, 165, 134);
widget.AppearanceCharacteristics.NormalCaption = "Print";
widget.TextProperties.FontSize = 20;
widget.TextProperties.Font = FontsRepository.Courier;
widget.TextProperties.Fill = new RgbColor(0, 0, 0);
widget.RecalculateContent();
RadFixedDocument fixedDocument = new RadFixedDocument();
fixedDocument.Pages.AddPage();
fixedDocument.AcroForm.FormFields.Add(pushButtonField);
fixedDocument.Pages[0].Annotations.Add(widget);
In .NET Standard/.NET (Target OS: None) environments, fonts beyond the 14 standard ones require a FontsProvider implementation to be resolved correctly.