Hyperlinks
- 2 minutes to read
This document introduces hyperlinks and explains how to customize hyperlink opening behavior.
A hyperlink is a reference to data that you can directly follow by clicking a document page. Hyperlinks can point to a page, an external document or to URI (uniform resource identifier).
To navigate to a specific location within a document, click a link that refers to that location.
If you click a hyperlink addressing an external URI, the PdfViewer.UriOpening event is handled.
The PdfViewer.UriOpening event allows you to customize the URI opening behavior. The PdfUriOpeningEventArgs.Handled property is set to false by default. In this case, the PDF Viewer invokes a Security Warning message box, which warns you that the PDF Viewer will use an external resource to open the URI.
ClickYes to open the URI in the PDF Viewer, otherwise click No. To hide the message box, set the PdfUriOpeningEventArgs.Handled property to true. You can prevent URI opening without using the message box by setting the e.Cancel property to true.
When you click a link in a PDF document to open an embedded or external document, the PdfViewer.ReferencedDocumentOpening event is raised. You can obtain the document file path using the PdfReferencedDocumentOpeningEventArgs.DocumentFilePath property and get information about whether or not the referenced document was opened in an external application using the PdfReferencedDocumentOpeningEventArgs.OpenInNewWindow property.