Report Units and Event Handling

Execute one of the operations:

Select the Development > Units and Events Handling main menu item.
Click the Units and Events Handling button on the toolbar.

The following operations are available when working with report units and event handler:

To create a unit that implements custom Fore functions/report event handling, execute one of the operations:

Click the Create Unit button.
Select the Create Unit item in the drop-down menu of the Actions button.

After executing one of the operations the new unit is created in the object navigator in the folder with the regular report and is opened in the development environment to be filled with code.

To create a unit implementing the EventsClass class with templates of handlers of all regular report events execute one of the operations:

Click the Create Handler button.
Select the Create Handler item in the drop-down menu of the Actions button.

After executing one of the operations the new unit is created in the object navigator in the folder with the regular report, is added to the list of units and is opened in the development environment to be filled with code.

To connect an existing unit/event handler:

Execute one of the operations:

Click the Select Unit button.
Select the Select Unit from Repository item in the drop-down menu of the Actions button.

The Select Unit dialog box opens:

To set up displaying of repository objects in the Select Unit dialog box:

Click the Display Object button.
Select one of the display versions in the drop-down menu:

Name. Default value.
Identifier.
Name and Identifier.

Select the unit in the repository object tree.

To quickly select the unit, use search. Enter the text to be searched in the search string. Search is executed automatically as the searched text is entered in the search string. The list will display only the units, which names/identifiers contain the entered text.

To reset the search results, click the Clear button.

After executing the operations, the unit is added to the list if units:

Set parameters in the Event Handling section for the event handler:

Unit. In the drop-down list select the unit containing class implementation for regular report event handling or select the Set Handler item in the drop-down menu of the Actions button in the list of units.
Class. In the drop-down list select the class inherited from the ReportEvents class that contains implementation of methods for handling regular report events. The list of classes is generated depending on the selected unit. Event handler class description can be created automatically.

Event handler class can have the constructor called at each class initialization. The designer must not contain parameters. If the class has several constructors without parameters, the first constructor is called that is located above the others in the code.

NOTE. Event class is initialized each time when an action is executed in the report. In this case wither one event or a chain of events can be generated.

After executing the operations, the selected unit/event handler is connected to the regular report.

NOTE. Only one event handling unit contained in the list if units can be connected to the report.

To reset the connected event handing unit, execute one of the operations:

Select the Reset Handler item in the drop-down menu of the Actions button in the list of units.
Click the Reset Handler button in the Unit parameter.

After executing one of the operations the current event handler is reset.

To open the unit/event handler in the development environment, select the Open in Development Environment item in the drop-down menu of the Actions button in the list of units. After this the selected unit will be opened in the development environment.

To remove the connected unit/event handler from the list of units, select the Remove item in the drop-down menu of the Actions button. After this the action confirmation dialog box opens. If the answer is positive, the selected unit will be removed from the list of units.

Example of Event Handler

To execute the example, create a unit. Add links to the Drawing, Express, Report, and Tab system assemblies.

Class EventsClass: ReportEvents
    // Event that occurs after report sheet calculation
    Public Sub OnAfterRecalcSheet(Sheet: IPrxSheet);
    Var
        Tab: ITabSheet;
        Range: ITabRange;
        Style: ITabCellStyle;
    Begin
        // Get report sheet table
        Tab := Sheet As ITabSheet;
        // Select cell range to be colored
        Range := Tab.Cells(0, 0, 10, 5);
        // Set formatting style for selected range
        Style := Range.Style;
        // Set green color of background for selected cell range
        Style.BackgroundBrush := New GxSolidBrush.Create(GxColor.FromName("Green"));
    End Sub OnAfterRecalcSheet(Sheet: IPrxSheet);
End Class EventsClass;

As a result, when the event occurs that follows regular report sheet calculation, background of the A0:F10 cell range is filled with green color.

Report Units and Event Handling

Working with Report Units/Event Handler

Example of Event Handler