[Expand]General Information
[Expand]WinForms Controls
[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
[Collapse]Reporting
 [Expand]Product Information
 [Expand]Get Started with DevExpress Reporting
 [Expand]Create Popular Reports
 [Collapse]Detailed Guide to DevExpress Reporting
   Introduction to Banded Reports
  [Expand]Provide Data to Reports
  [Expand]Use Report Controls
  [Expand]Shape Report Data
   Lay out Dynamic Report Contents
  [Expand]Customize Appearance
  [Collapse]Add Navigation
    Add Page Numbers
    Add Cross-References and Hyperlinks
    Add Bookmarks and a Document Map
    Add a Table of Contents
  [Expand]Provide Interactivity
  [Expand]Add Extra Information
  [Expand]Merge Reports
  [Expand]Use Expressions
  [Expand]Store and Distribute Reports
  [Expand]Reporting API
 [Expand]Visual Studio Report Designer
 [Expand]Create End-User Reporting Applications
 [Expand]API Reference
[Expand]Report and Dashboard Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Add Cross-References and Hyperlinks

This document describes how to make an element navigate to other elements in a report or external resources by clicking it in a Print Preview.

Expanded Add Cross-References

You can improve report navigation using a cross-reference because the link's target is in the same document.

You can add a cross-reference for a report control by setting the following properties:

  1. Set the XRControl.Target property to _self to specify that the link is in the same document.

  2. Se the XRControl.NavigateUrl property to the required target control's XRControl.Name property value.

In this case, the control behaves like a link meaning that the cursor automatically changes to a hand in a report's preview when hovering the control. You can make a control resemble a link by specifying its Appearance Properties (for example, change the text's color to blue and underline it).

The link uses the first occurrence if there are multiple instances of an object marked as a link's target.

Tip

A report's cross-references are preserved when exporting it to PDF.

Expanded Add Hyperlinks

A hyperlink means that a link's target is outside the report.

You can use any control as a link by setting the XRControl.NavigateUrl property to the required target document's URL.

Note

Remember to use the "http://" or "https://" prefix when specifying the URL.

You can make a control resemble a link by specifying its Appearance Properties (for instance, set the underlined text and blue color).

The cursor automatically changes to a hand when hovering the control in a report's preview.

Use the link's XRControl.Target property to specify where to open the target document (in the same preview window, in a new blank window, etc.).

Tip

A link's behavior is preserved when exporting a report to most of the available formats (in particular to PDF, HTML, MHT, RTF and Excel).

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