Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[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]Document Server
[Collapse]Reporting
 [Expand]Product Information
 [Collapse]Creating Reports in Visual Studio
  [Expand]Adding a Report to Your .NET Application
  [Expand]Getting Started with DevExpress Reporting
  [Collapse]Detailed Guide to DevExpress Reporting
   [Expand]Storing and Distributing Reports
   [Expand]Providing Data to Reports
   [Expand]Shaping Report Data
   [Collapse]Report Navigation, Interactivity and Appearance
    [Collapse]Report Navigation
      Adding Page Numbers
      Adding Cross-References and Hyperlinks
      Adding Bookmarks and a Document Map
      Adding a Table of Contents
    [Expand]Report Interactivity
    [Expand]Report Appearance
   [Expand]Reporting API
  [Expand]Detailed Guide to Visual Studio Report Designer
 [Expand]Creating End-User Reporting Applications
 [Expand]API Reference
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Adding 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 Adding 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 its XRControl.NavigateUrl property to the required target control's XRControl.Name property value.

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

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 Adding 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).

How would you rate this topic?​​​​​​​