[Expand]General Information
[Collapse]WinForms Controls
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Property Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Map Control
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Collapse]PDF Viewer
   [Expand]Getting Started
    Coordinate Systems
    [Expand]Navigating and Viewing a Document
     Navigation Pane
   [Expand]Access and Edit Document Content
  [Expand]TreeMap Control
  [Expand]Sunburst Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)


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.

Is this topic helpful?​​​​​​​