New to Telerik ReportingStart a free 30-day trial

Represents a builder that provides a fluent API for configuring client-side event handlers of the MVC Report Viewer. Used to attach JavaScript functions that respond to various report viewer events during report rendering, printing, exporting, and user interaction.

Definition

Namespace:Telerik.ReportViewer.Mvc

Assembly:Telerik.ReportViewer.Mvc.dll

Syntax:

C#
public interface IClientEventsBuilder

Methods

Attaches an event handler that will be called when an error occurs.

C#
IClientEventsBuilder Error(string onError)
Parameters:onErrorstring

The name of the JavaScript handler function (without parentheses) that handles error events.

Returns:

IClientEventsBuilder

The current IClientEventsBuilder instance for method chaining.

Remarks:

The error event is triggered when any error occurs during report processing, rendering, or viewer operations.

Attaches an event handler that will be called prior to starting the report export command.

C#
IClientEventsBuilder ExportBegin(string onExportBegin)
Parameters:onExportBeginstring

The name of the JavaScript handler function (without parentheses) that handles the export begin event.

Returns:

IClientEventsBuilder

The current IClientEventsBuilder instance for method chaining.

Remarks:

The export begin event is triggered before the report viewer starts generating the export document.

Attaches an event handler that will be called when the exported document is ready for download, but prior to the actual downloading.

C#
IClientEventsBuilder ExportEnd(string onExportEnd)
Parameters:onExportEndstring

The name of the JavaScript handler function (without parentheses) that handles the export end event.

Returns:

IClientEventsBuilder

The current IClientEventsBuilder instance for method chaining.

Remarks:

The export end event is triggered when the export document is ready but before the download starts.

Attaches an event handler that will be called when the mouse cursor enters the action's report item area.

C#
IClientEventsBuilder InteractiveActionEnter(string onInteractiveActionEnter)
Parameters:onInteractiveActionEnterstring

The name of the JavaScript handler function (without parentheses) that handles the interactive action enter event.

Returns:

IClientEventsBuilder

The current IClientEventsBuilder instance for method chaining.

Remarks:

The interactive action enter event is triggered when the mouse hovers over interactive report elements.

Attaches an event handler that will be called when an interactive action is executed.

C#
IClientEventsBuilder InteractiveActionExecuting(string onInteractiveActionExecuting)
Parameters:onInteractiveActionExecutingstring

The name of the JavaScript handler function (without parentheses) that handles the interactive action executing event.

Returns:

IClientEventsBuilder

The current IClientEventsBuilder instance for method chaining.

Remarks:

The interactive action executing event is triggered when user clicks on interactive elements like drill-through links or toggle buttons.

Attaches an event handler that will be called when the mouse cursor leaves the action's report item area.

C#
IClientEventsBuilder InteractiveActionLeave(string onInteractiveActionLeave)
Parameters:onInteractiveActionLeavestring

The name of the JavaScript handler function (without parentheses) that handles the interactive action leave event.

Returns:

IClientEventsBuilder

The current IClientEventsBuilder instance for method chaining.

Remarks:

The interactive action leave event is triggered when the mouse cursor moves away from interactive report elements.

Attaches an event handler that will be called every time a page from the report is rendered and ready for display.

C#
IClientEventsBuilder PageReady(string onPageReady)
Parameters:onPageReadystring

The name of the JavaScript handler function (without parentheses) that handles the page ready event.

Returns:

IClientEventsBuilder

The current IClientEventsBuilder instance for method chaining.

Remarks:

The page ready event is triggered when each individual report page completes rendering and is ready for display.

Attaches an event handler that will be called prior to starting the print report command.

C#
IClientEventsBuilder PrintBegin(string onPrintBegin)
Parameters:onPrintBeginstring

The name of the JavaScript handler function (without parentheses) that handles the print begin event.

Returns:

IClientEventsBuilder

The current IClientEventsBuilder instance for method chaining.

Remarks:

The print begin event is triggered before the report viewer starts generating the print document.

Attaches an event handler that will be called when the print document (Adobe PDF) is ready for download, but prior to being sent to the printer.

C#
IClientEventsBuilder PrintEnd(string onPrintEnd)
Parameters:onPrintEndstring

The name of the JavaScript handler function (without parentheses) that handles the print end event.

Returns:

IClientEventsBuilder

The current IClientEventsBuilder instance for method chaining.

Remarks:

The print end event is triggered when the PDF print document is ready but before actual printing occurs.

Attaches an event handler that will be called when the report viewer template is loaded.

C#
IClientEventsBuilder Ready(string onReady)
Parameters:onReadystring

The name of the JavaScript handler function (without parentheses) that handles the ready event.

Returns:

IClientEventsBuilder

The current IClientEventsBuilder instance for method chaining.

Remarks:

The ready event is triggered when the report viewer template and UI components are fully loaded and initialized.

Attaches an event handler that will be called when the rendering of the report begins.

C#
IClientEventsBuilder RenderingBegin(string onRenderingBegin)
Parameters:onRenderingBeginstring

The name of the JavaScript handler function (without parentheses) that handles the rendering begin event.

Returns:

IClientEventsBuilder

The current IClientEventsBuilder instance for method chaining.

Remarks:

The rendering begin event is triggered when the report viewer starts processing and rendering the report content.

Attaches an event handler that will be called when the rendering of the report ends.

C#
IClientEventsBuilder RenderingEnd(string onRenderingEnd)
Parameters:onRenderingEndstring

The name of the JavaScript handler function (without parentheses) that handles the rendering end event.

Returns:

IClientEventsBuilder

The current IClientEventsBuilder instance for method chaining.

Remarks:

The rendering end event is triggered when the report viewer completes processing and rendering the report content.

Attaches an event handler that will be called every time the UI needs an update; can be used for changing the UI of the report viewer while interacting with reports.

C#
IClientEventsBuilder UpdateUi(string onUpdateUi)
Parameters:onUpdateUistring

The name of the JavaScript handler function (without parentheses) that handles the UI update event.

Returns:

IClientEventsBuilder

The current IClientEventsBuilder instance for method chaining.

Remarks:

The UI update event is triggered whenever the report viewer interface needs to refresh during user interactions.

Attaches an event handler that will be called when a tooltip is being opened.

C#
IClientEventsBuilder ViewerToolTipOpening(string onViewerToolTipOpening)
Parameters:onViewerToolTipOpeningstring

The name of the JavaScript handler function (without parentheses) that handles the tooltip opening event.

Returns:

IClientEventsBuilder

The current IClientEventsBuilder instance for method chaining.

Remarks:

The tooltip opening event is triggered when tooltips are about to be displayed for report elements or viewer controls.