reporting-docs/knowledge-base/add-header-printable-on-eve...

3.4 KiB

title page_title description type slug res_type
Add Header Printable on Every Page to List Data Item Add Table Header to List Item Learn how you may add a static Table Header that may be printed on every page to a List Data Item in Telerik Reporting. how-to add-header-printable-on-every-page-to-list kb

Environment

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

Description

When you add a [List data item]({%slug table_template_items%}#list) in the report designer, it contains only a detail group with a [Panel]({%slug telerikreporting/designing-reports/report-structure/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]({%slug table_template_items%}) 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]({%slug telerikreporting/designing-reports/report-designer-tools/desktop-designers/tools/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]({%slug telerikreporting/designing-reports/report-designer-tools/desktop-designers/tools/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

  • [Table Overview]({%slug telerikreporting/designing-reports/report-structure/table-crosstab-list/overview%})
  • [Crosstab Areas]({%slug telerikreporting/designing-reports/report-structure/table-crosstab-list/understanding-crosstab-areas%})
  • [Table Cells, Rows, and Columns]({%slug telerikreporting/designing-reports/report-structure/table-crosstab-list/understanding-table-cells,-rows-and-columns%})