New to Telerik Reporting? Download free 30-day trial

Add Header Printable on Every Page to List Data Item

Environment

Product Progress® Telerik® Reporting
Report Designers Visual Studio/Standalone Report Designer

Description

When you add a List data item in the report designer, it contains only a detail group with a Panel inside:

List item when added to a new report in the Standalone Report Designer.

In many scenarios, you may need to add and display Headers in the List that repeat on every page.

Solution

The List is a variation of the Table as explained in the article Template Variations of the Table Report Item and exposes the property ColumnHeadersPrintOnEveryPage. The property lets you print the Table Header on every page where the table/list appears.

By default, the List lacks the Table Header, so we must add it to use the property and display a header on every page. Here are the necessary steps:

  1. Insert a Row into the List:

    • Right-click over the List to open the Context Menu
    • Select Insert Row -> Outside Group - Above

    Insert a row to the List in the Standalone Report Designer.

    The new row is a header for your List. You may display aggregated values from the DataSource of the List like Totals, Averages, etc. This row cannot be displayed on every page.

  2. Add a Parent Group to the Column group defined by the just inserted row:

    • Select the List and go to the Group Explorer. Ensure the Group Explorer is in Extended Mode that displays the static groups.
    • Right-click over the column group to open the Context Menu
    • Select Add Group -> Parent Group. This opens the Table Group wizard:

      Add Parent group to the Column Group of the List in the Standalone Report Designer.

    • Add a constant value, for example, 1 as a Grouping Expression. You may need to check and uncheck the Add Header/Footer to enable the OK button that will let you proceed:

      Configure the static Table Group of the List in the Standalone Report Designer.

    The wizard adds a new Table Header to the List. This is the header that respects the ColumnHeadersPrintOnEveryPage property.

  3. (optional) Delete the row we added in Step 1 if you don't need it.

See Also

In this article