Create a Feature Report with a Custom TOC Level

Environment

Product	Progress® Telerik® Reporting
Product Version	2026 Q1 (20.0.26.402) and later
Report Designer	Standalone Report Designer or Visual Studio Report Designer

Description

Create a simple feature report that demonstrates how TocLevel controls the TOC hierarchy independently from the default report structure.

The walkthrough uses static content so that you can reproduce the result without a custom data source.

Solution

Use this procedure:

1. Create a new blank report.
2. Add a Table of Contents section from the report context menu.
3. In the Properties pane of the TOC section, open the Levels editor and add three levels.
4. In the report Detail section, add three TextBox items and set these values:
   • TextBoxCountry:
     • Value: Country
     • TocText: Country
   • TextBoxCity:
     • Value: City
     • TocText: City
   • TextBoxStore:
     • Value: Store Name
     • TocText: Store Name
5. Preview the report and verify that the TOC order follows the default hierarchy and item order.
6. Return to design view and set explicit TOC levels:
   • TextBoxCountry -> TocLevel = 1
   • TextBoxStore -> TocLevel = 2
   • TextBoxCity -> TocLevel = 3
7. Preview the report again and verify that the TOC now uses the custom level mapping.

The following structure is expected after the override:

text

Level 1
└─ Country

Level 2
└─ Store Name

Level 3
└─ City

TocLevel has effect only when TocText is set on the same report item, section, or group.

TocLevel must evaluate to an integer that is greater than or equal to 1.

See Also

• Table of Contents Overview
• Controlled TOC Hierarchy
• ReportItemBase.TocText API
• ReportItemBase.TocLevel API