Skip to main content

ViewerApiExtensionEvents Type

Describes events this extension fires.

#Declaration

TypeScript
export type ViewerApiExtensionEvents = {
    itemClick: DevExpress.Dashboard.ItemClickEventArgs;
    itemSelectionChanged: DevExpress.Dashboard.ItemSelectionChangedEventArgs;
    itemWidgetCreated: DevExpress.Dashboard.ItemWidgetEventArgs;
    itemWidgetUpdating: DevExpress.Dashboard.ItemWidgetEventArgs;
    itemWidgetUpdated: DevExpress.Dashboard.ItemWidgetEventArgs;
    itemWidgetOptionsPrepared: DevExpress.Dashboard.ItemWidgetOptionEventArgs;
    itemElementCustomColor: DevExpress.Dashboard.ItemElementCustomColorEventArgs;
    itemVisualInteractivity: DevExpress.Dashboard.ItemVisualInteractivityEventArgs;
    itemMasterFilterStateChanged: DevExpress.Dashboard.ItemMasterFilterStateChangedEventArgs;
    itemDrillDownStateChanged: DevExpress.Dashboard.ItemDrillDownStateChangedEventArgs;
    itemActionAvailabilityChanged: DevExpress.Dashboard.ItemActionAvailabilityChangedEventArgs;
    itemCaptionToolbarUpdated: DevExpress.Dashboard.ItemCaptionToolbarUpdatedEventArgs;
    dashboardTitleToolbarUpdated: DevExpress.Dashboard.DashboardTitleToolbarUpdatedEventArgs;
    selectedTabPageChanged: DevExpress.Dashboard.SelectedTabPageChangedEventArgs;
}

#Members

Name Type Description
dashboardTitleToolbarUpdated DashboardTitleToolbarUpdatedEventArgs

A handler for the event that occurs before the dashboard title toolbar is updated.

itemActionAvailabilityChanged ItemActionAvailabilityChangedEventArgs

A handler for the event that occurrs after the available interactivity actions for the specific dashboard item changes.

itemCaptionToolbarUpdated ItemCaptionToolbarUpdatedEventArgs

A handler for the event that occurs before the dashboard item caption toolbar is updated.

itemClick ItemClickEventArgs

A handler for the event that occurs when a user clicks a dashboard item.

itemDrillDownStateChanged ItemDrillDownStateChangedEventArgs

A handler for the event that occurs when a drill-down/drill-up is performed.

itemElementCustomColor ItemElementCustomColorEventArgs

A handler for the event that allows you to paint the dashboard item elements with the specified colors.

itemMasterFilterStateChanged ItemMasterFilterStateChangedEventArgs

A handler for the event that occurs when the master filter state is changed.

itemSelectionChanged ItemSelectionChangedEventArgs

A handler for the event that occurs after the selection within the dashboard item is changed.

itemVisualInteractivity ItemVisualInteractivityEventArgs

A handler for the event that allows you to provide custom visual interactivity for data-bound dashboard items that support element selection and highlighting.

itemWidgetCreated ItemWidgetEventArgs

A handler for the event that allows you to access underlying UI/Data Visualization widgets.

itemWidgetOptionsPrepared ItemWidgetOptionEventArgs

A handler for the event that allows you to access underlying UI/Data Visualization widgets and configure their options.

itemWidgetUpdated ItemWidgetEventArgs

A handler for the event that allows you to access underlying UI/Data Visualization widgets.

itemWidgetUpdating ItemWidgetEventArgs

A handler for the event that allows you to access underlying UI/Data Visualization widgets.

selectedTabPageChanged SelectedTabPageChangedEventArgs

A handler for the event that occurs when the selected tab page is changed.

#Remarks

Find the extension by its name (viewerApi) and pass the event handler’s name to subscribe to the ViewerApiExtension events.

The following code handles the onDashboardTitleToolbarUpdated event:

javascript
function onBeforeRender(dashboardControl) {
  let viewerApiExtension = dashboardControl.findExtension("viewerApi");
  if (viewerApiExtension) {
    viewerApiExtension.on('dashboardTitleToolbarUpdated', customizeDashboardTitleToolbar);
  }
}
function customizeDashboardTitleToolbar(args) {
  // ...
}