Log In
[Expand]Welcome to DevExpress .NET Documentation
[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
 [Expand]Product Information
 [Collapse]Creating Reports in Visual Studio
  [Expand]Adding a Report to Your .NET Application
  [Expand]Getting Started with DevExpress Reporting
  [Expand]Detailed Guide to DevExpress Reporting
  [Collapse]Detailed Guide to Visual Studio Report Designer
   [Collapse]Toolbox - Supported Report Controls
    [Collapse]Using Basic Report Controls
      Character Comb
      Rich Text
      Check Box
      Picture Box
      Zip Code
      Page Break
      Table of Contents
      Page Info
    [Expand]Using Bar Codes
    [Expand]Using Charts and Pivot Grids
    [Expand]Using Gauges and Sparklines
    [Expand]Drawing Lines and Shapes
    [Expand]Using Custom and Third-Party Controls
   [Expand]Dock Panels and Designer Options
   [Expand]Report Wizard
 [Expand]Creating End-User Reporting Applications
 [Expand]API Reference
[Expand]Report Server
[Expand]eXpressApp Framework
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Table of Contents

This document describes how to insert a table of contents into a document by using a dedicated report control, and consists of the following sections.

Expanded Table of Contents Overview

Once bookmarks have been assigned to specific report elements, you can generate a table of contents that displays page numbers containing the elements included into the document map.

The following image illustrates the difference in displaying information by a table of contents within a report and in a published document.

To implement a table of contents, drop the XRTableOfContents control from the Toolbox DX.17.2: Report Controls tab onto the report surface. If the report does not contain a Report Header at the moment, it will be created automatically so that the table of contents can be added to it.

Expanded Table of Contents Structure

The table of contents contains the following elements.

  1. A title (corresponding to the XRTableOfContentsTitle class) that displays text and formatting options specified by the XRTableOfContents.LevelTitle property.

  2. One or more document levels (corresponding to the XRTableOfContentsLevel class) that provide individual formatting settings to specific nodes of a document map's tree.

    To access the collection of levels, use the XRTableOfContents.Levels property.

    Unless levels have been added to a table of contents, a single default level is used to provide common settings to the elements of a document map for which no specific level has yet been assigned.

Expanded Managing Document Levels

To add a new level to the table of contents, do the following.

  1. Select the table of contents and click its smart tag.

    In the invoked actions list, click the ellipsis button for the Levels property.

  2. In the invoked collection editor, click Add.

  3. Specify the formatting settings for the created level and click OK to exit the dialog.

To customize the indentation settings of a document level, use its XRTableOfContentsLevel.Indent property. A zero value assigned to this property assumes the default indent settings.

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