Using Render Events on Group Header Bands in Report Designer

Using Render Events on Group Header Bands in Report Designer

The articles in this section of the Knowledge Base involve working with Groups for display in reports. To learn more about Groups and how to access the Report Designer, see Understanding Groups in the Report Designer. This article details Events in regards to Groups.

Just like with a Data band, the Group Header band has three specific rendering events available. While Rendering Events are applied to individual Data Rows when assigned to the Data band, when assigned to the Group Header band, the events are applied to groups.

To access these events, select the Group Header band and select the Events button  at the top of the Properties window. 


Fig. 01 – Render Events

  1. Begin Render Event
The Begin Render Event is called at the beginning of a new group being output. This event can be used for the initialization of data or variables, or for calling certain actions.
  1. End Render Event
The End Render Event is called after the group is rendered. Data processing and the calculation of totals are usually performed in the handler of this event.
  1. Rendering Event
The Rendering Event is called when the report generator is rendering one data row from a group.

The following tutorial provides an example for working with these events:

  1. Create the “counter” variable in the Data Dictionary.
    1. Select the Page tab > select Panels > select Dictionary.

      2. Fig. 02 – Dictionary

    2. Select New Item > New Variable.

      3. Fig. 03 – New Variable

    3. From the New Variable window, create a new int type variable named “counter.” Assign it a value of “0.” See Figure 04.

      4. Fig. 04 – New Variable Dialog

  2. Close the Dictionary Window > select the Group Header band for the event to be applied to > select the Events tab > write the following code in the Begin Render Event:
    3. counter = counter + 1

    Fig. 05 – Render Events

    The counter variable increases by one each time a new group is rendered. The report in this example is grouped by materials, so counter is keeping track of the number of materials in the report.

  3. Enter the following expression into a Text Component where you want the counter value to be displayed:
    4. {counter}

    Fig. 06 – “counter” Text Component

    This has been entered into the standard Footer band for the entire report. 
  4. Process the report. The results should look something like Figure 07. 

    5. Fig. 07 – Report Example

    • Related Articles

    • Using Render Events on Data Bands in Report Designer

      The articles in this section of the Knowledge Base involve working with Lists for display in your reports. To learn more about Lists and how to access the Report Designer, see Creating Lists in Report Designer. This article provides information on ...

    • Using the Column Header Band in Report Designer

      The articles in this section of the Knowledge Base involve working with Columns for display in multi-column reports. To learn more about Columns and how to access the Report Designer, see Creating Multi-Column Reports in Report Designer. This article ...

    • Understanding Report Bands in Report Designer

      The articles in this section of the Knowledge Base involve working with Report Bands for display in your reports. To access the Report Designer, select Toolbox Setup > Design Reports > Design (Report Type) Report. Select New Report to design a report ...

    • Using the Group Footer Band in Report Designer

      The articles in this section of the Knowledge Base involve working with Groups for display in reports. To learn more about Groups and how to access the Report Designer, see Understanding Groups in the Report Designer. This article regards working ...

    • Using Group Properties in Report Designer

      The articles in this section of the Knowledge Base involve working with Groups for display in reports. To learn more about Groups and how to access the Report Designer, see Understanding Groups in the Report Designer. This article details properties ...

    • Recent Articles

    • Microvellum Foundation Library Release Notes | Build 26.0527

      The following release notes apply to the Microvellum Foundation Library build 26.0527. Additions Added new features for the Wood Drawer Box to have reduced sides, sub front, or back. Added 3 new global and subassembly prompts: “Wood Drawer Side ...

    • Microvellum Release Notes | Build 26.1.0529.641

      The following release notes apply to Microvellum build 26.1.0529.641. BSB Docking Size Fix An issue was reported to be occurring in Microvellum BSB 2026: when adjusting the size of a docked Microvellum palette, users found that the palette would ...

    • Adding Custom Hinges and Mounting Plates (Foundation Library)

      Hinges and mounting plates are classified as hardware items within the Foundation library, and as such, the process for adding hinges and mounting plates does not differ greatly from other pieces of hardware, though with the variety of cabinet ...

    • Apply Render Materials

      The Apply Render Materials interface is a Microvellum function that allows one to assign specific render materials to database materials within one’s material library. Using this interface, one can efficiently control and visually align one’s ...

    • Microvellum Release Notes | Build 26.1.0520.641

      The following release notes apply to Microvellum build 26.1.0520.641. Assign Render Material A new option has been added to the Library Specification Groups interface: Assign Render Material. This new interface displays the Microvellum material ...