GridView.AutoUpdateByHandler

Syntax

AutoUpdateByHandler: Boolean;

Description

The AutoUpdateByHandler property determines whether the ReportEvents.OnCellChange event, that occurs on changing regular report value cell, is handled.

Comments

The ReportEvents.OnCellChange event is used to execute the specified action algorithm on changing regular report cell value. For example, on changing cell values, data aggregation is executed.

NOTE. In the web application, regular report cells can be changed only within table.

To connect event handler to the report, see theReport Events Handling section.

Available values:

True. The event is executed on changing regular report cell.
False. By default. The event is not executed on changing regular report cell.

The property value is set using the setAutoUpdateByHandler method and it is returned by the getAutoUpdateByHandler method.

Example

To execute this example, the HTML page must contain the ReportBox component named reportBox (see. Example of the ReportBox Component Layout). Make sure that repository contain a regular report with the 3275 key containing data table and event handling unit, executing theReportEvents.OnCellChange event, is connected. The script below is executed in browser console:

// Get data area view
dataView = reportBox.getDataView();
// Get table
gridView = dataView.getGridView();
// Enable executing the ReportEvents.OnCellChange event
gridView.setAutoUpdateByHandler(true);

After executing the example, the ReportEvents.OnCellChange event is executed on changing cell value in regular report table.