ASPxClientDashboard Class
A client-side equivalent of the ASPxDashboard control.
Declaration
declare class ASPxClientDashboard extends ASPxClientControlRemarks
To learn more, see Client-Side Functionality.
Inherited Members
Inheritance
Methods
CanClearMasterFilter(itemName) Method
Returns whether the specified master filter can be cleared in the current state.
Declaration
CanClearMasterFilter(
itemName: string
): booleanParameters
| Name | Type | Description |
|---|---|---|
| itemName | string | A string that specifies the component name of the master filter item. |
Returns
| Type | Description |
|---|---|
| boolean | true, if the specified master filter can be cleared in the current state; otherwise, false. |
Remarks
To clear the specified master filter item, use the ASPxClientDashboard.ClearMasterFilter method.
Example
The following example demonstrates how to apply master filtering in the Web Dashboard on the client side.
In this example, the ASPxClientDashboard.SetMasterFilter method is used to select required rows in the Grid dashboard item while the ASPxClientDashboard.SetRange method is called to select the required range in the Range Filter dashboard item. These methods are called in the onClick event handler of the dxButton.
Note
A complete sample project is available at https://github.com/DevExpress-Examples/aspxdashboard-how-to-apply-master-filtering-in-code-t490897.
Imports System
Imports System.Collections.Generic
Imports System.Linq
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls
Namespace WebDashboard_SetMasterFilter
Partial Public Class WebForm1
Inherits System.Web.UI.Page
Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
ASPxDashboard1.DashboardXmlPath = Server.MapPath("App_Data/Dashboard.xml")
End Sub
End Class
End Namespace
CanPerformDrillDown(itemName) Method
Returns whether drill down is possible in the current state of the specified dashboard item.
Declaration
CanPerformDrillDown(
itemName: string
): booleanParameters
| Name | Type | Description |
|---|---|---|
| itemName | string | A string that specifies the component name of the dashboard item. |
Returns
| Type | Description |
|---|---|
| boolean | true, if drill down is possible in the current state of the specified dashboard item; otherwise, false. |
CanPerformDrillUp(itemName) Method
Returns whether drill up is possible in the current state of the specified dashboard item.
Declaration
CanPerformDrillUp(
itemName: string
): booleanParameters
| Name | Type | Description |
|---|---|---|
| itemName | string | A string that specifies the component name of the dashboard item. |
Returns
| Type | Description |
|---|---|
| boolean | true, if drill up is possible in the current state of the specified dashboard item; otherwise, false. |
CanSetMasterFilter(itemName) Method
Returns whether master filtering can be applied in the current state of the specified master filter item.
Declaration
CanSetMasterFilter(
itemName: string
): booleanParameters
| Name | Type | Description |
|---|---|---|
| itemName | string | A string that specifies the component name of the master filter item. |
Returns
| Type | Description |
|---|---|
| boolean | true, if master filtering can be applied in the current state of the specified master filter item; otherwise, false. |
Example
The following example demonstrates how to apply master filtering in the Web Dashboard on the client side.
In this example, the ASPxClientDashboard.SetMasterFilter method is used to select required rows in the Grid dashboard item while the ASPxClientDashboard.SetRange method is called to select the required range in the Range Filter dashboard item. These methods are called in the onClick event handler of the dxButton.
Note
A complete sample project is available at https://github.com/DevExpress-Examples/aspxdashboard-how-to-apply-master-filtering-in-code-t490897.
Imports System
Imports System.Collections.Generic
Imports System.Linq
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls
Namespace WebDashboard_SetMasterFilter
Partial Public Class WebForm1
Inherits System.Web.UI.Page
Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
ASPxDashboard1.DashboardXmlPath = Server.MapPath("App_Data/Dashboard.xml")
End Sub
End Class
End Namespace
ClearMasterFilter(itemName) Method
Clears the specified master filter item.
Declaration
ClearMasterFilter(
itemName: string
): voidParameters
| Name | Type | Description |
|---|---|---|
| itemName | string | A String that specifies the component name of the master filter item. |
Example
The following example demonstrates how to apply master filtering in the Web Dashboard on the client side.
In this example, the ASPxClientDashboard.SetMasterFilter method is used to select required rows in the Grid dashboard item while the ASPxClientDashboard.SetRange method is called to select the required range in the Range Filter dashboard item. These methods are called in the onClick event handler of the dxButton.
Note
A complete sample project is available at https://github.com/DevExpress-Examples/aspxdashboard-how-to-apply-master-filtering-in-code-t490897.
Imports System
Imports System.Collections.Generic
Imports System.Linq
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls
Namespace WebDashboard_SetMasterFilter
Partial Public Class WebForm1
Inherits System.Web.UI.Page
Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
ASPxDashboard1.DashboardXmlPath = Server.MapPath("App_Data/Dashboard.xml")
End Sub
End Class
End Namespace
ExportDashboardItemToExcel(itemName) Method
Exports a dashboard item to an Excel file and writes it to the Response.
Declaration
ExportDashboardItemToExcel(
itemName: string,
options?: DashboardExcelExportOptions | ASPxClientDashboardExportOptions,
fileName?: string
): voidParameters
| Name | Type | Description |
|---|---|---|
| itemName | string | A string that is the component name of the dashboard item to be exported. |
| options | DashboardExcelExportOptions | ASPxClientDashboardExportOptions | |
| fileName | string |
ExportDashboardItemToImage(itemName) Method
Exports a dashboard item to an Image file and writes it to the Response.
Declaration
ExportDashboardItemToImage(
itemName: string,
options?: DashboardImageExportOptions | ASPxClientDashboardExportOptions,
fileName?: string
): voidParameters
| Name | Type | Description |
|---|---|---|
| itemName | string | A string that is the component name of the dashboard item to be exported. |
| options | DashboardImageExportOptions | ASPxClientDashboardExportOptions | |
| fileName | string |
ExportDashboardItemToPdf(itemName) Method
Exports a dashboard item to a PDF file and writes it to the Response.
Declaration
ExportDashboardItemToPdf(
itemName: string,
options?: DashboardPdfExportOptions | ASPxClientDashboardExportOptions,
fileName?: string
): voidParameters
| Name | Type | Description |
|---|---|---|
| itemName | string | A string that is the component name of the dashboard item to be exported. |
| options | DashboardPdfExportOptions | ASPxClientDashboardExportOptions | |
| fileName | string |
ExportToExcel Method
Exports dashboard data to the specified file in Excel format.
Declaration
ExportToExcel(
options?: DashboardExcelExportOptions,
fileName?: string
): voidParameters
| Name | Type |
|---|---|
| options | DashboardExcelExportOptions |
| fileName | string |
ExportToImage Method
Exports a dashboard to an Image file and writes it to the Response.
Declaration
ExportToImage(
options?: DashboardImageExportOptions | ASPxClientDashboardExportOptions,
fileName?: string
): voidParameters
| Name | Type |
|---|---|
| options | DashboardImageExportOptions | ASPxClientDashboardExportOptions |
| fileName | string |
ExportToPdf Method
Exports a dashboard to a PDF file and writes it to the Response.
Declaration
ExportToPdf(
options?: DashboardPdfExportOptions | ASPxClientDashboardExportOptions,
fileName?: string
): voidParameters
| Name | Type |
|---|---|
| options | DashboardPdfExportOptions | ASPxClientDashboardExportOptions |
| fileName | string |
GetAvailableDrillDownValues(itemName) Method
Returns axis point tuples identifying elements that can be used to perform drill-down in the specified dashboard item.
Declaration
GetAvailableDrillDownValues(
itemName: string
): ASPxClientDashboardItemDataAxisPointTuple[]Parameters
| Name | Type | Description |
|---|---|---|
| itemName | string | A String that is the component name of the dashboard item. |
Returns
| Type | Description |
|---|---|
| ASPxClientDashboardItemDataAxisPointTuple[] | An array of ASPxClientDashboardItemDataAxisPointTuple objects identifying elements that can be used to perform drill-down in the specified dashboard item. |
Example
The following example demonstrates how to perform a drill-down in ASPxDashboard on the client side.
In this example, the ASPxClientDashboard.PerformDrillDown method is used to perform a drill-down for a specified row in a Grid dashboard item. The dxSelectBox widget contains categories for which a drill-down can be performed. These categories are obtained using the ASPxClientDashboard.GetAvailableDrillDownValues method. Select a required category and click the Perform Drill-Down button to perform a drill-down by the selected category.
When the Grid displays a list of products (the bottom-most detail level), you can only perform a drill-up action that returns you to the top detail level. The ASPxClientDashboard.PerformDrillUp method is called to do this.
Note
A complete sample project is available at https://github.com/DevExpress-Examples/aspxdashboard-how-to-perform-a-drill-down-in-code-t495048.
Dim access97Params As New Access97ConnectionParameters()
access97Params.FileName = "..\..\Data\nwind.mdb"
Dim sqlDataSource As New DashboardSqlDataSource("SQL Data Source 1", access97Params)
Dim selectQuery As SelectQuery = SelectQueryFluentBuilder.AddTable("SalesPerson"). _
SelectColumns("CategoryName", "Sales Person", "OrderDate", "Extended Price").Build("Query 1")
sqlDataSource.Queries.Add(selectQuery)
sqlDataSource.Fill()
dashboardDesigner1.Dashboard.DataSources.Add(sqlDataSource)
GetAvailableFilterValues(itemName) Method
Returns axis point tuples identifying elements that can be selected in the current state of the master filter item.
Declaration
GetAvailableFilterValues(
itemName: string
): ASPxClientDashboardItemDataAxisPointTuple[]Parameters
| Name | Type | Description |
|---|---|---|
| itemName | string | A String that is the component name of the master filter item. |
Returns
| Type | Description |
|---|---|
| ASPxClientDashboardItemDataAxisPointTuple[] | An array of ASPxClientDashboardItemDataAxisPointTuple objects identifying elements that can be selected in the current state of the master filter item. |
GetAvailablePredefinedRanges(itemName) Method
Returns names of the predefined ranges available for the specified Range Filter.
Declaration
GetAvailablePredefinedRanges(
itemName: string
): string[]Parameters
| Name | Type | Description |
|---|---|---|
| itemName | string | A string value that specifies the component name of the Range Filter dashboard item. |
Returns
| Type | Description |
|---|---|
| string[] | An array of string values that are names of the available predefined ranges. |
Remarks
Use the GetAvailablePredefinedRanges method after the Range Filter has loaded data. When the Range Filter has no data to display, the GetAvailablePredefinedRanges method returns null.
GetCurrentDrillDownValues(itemName) Method
Returns the axis point tuple identifying the current drill-down state.
Declaration
GetCurrentDrillDownValues(
itemName: string
): ASPxClientDashboardItemDataAxisPointTupleParameters
| Name | Type | Description |
|---|---|---|
| itemName | string | A String that is the component name of the dashboard item. |
Returns
| Type | Description |
|---|---|
| ASPxClientDashboardItemDataAxisPointTuple | An ASPxClientDashboardItemDataAxisPointTuple object representing a set of axis points. |
GetCurrentFilterValues(itemName) Method
Returns axis point tuples identifying currently selected elements in the master filter item.
Declaration
GetCurrentFilterValues(
itemName: string
): ASPxClientDashboardItemDataAxisPointTuple[]Parameters
| Name | Type | Description |
|---|---|---|
| itemName | string | A String that is the component name of the master filter item. |
Returns
| Type | Description |
|---|---|
| ASPxClientDashboardItemDataAxisPointTuple[] | An array of ASPxClientDashboardItemDataAxisPointTuple objects identifying elements that can be selected in the current state of the master filter item. |
GetCurrentPredefinedRange(itemName) Method
Returns the name of the currently selected predefined range.
Declaration
GetCurrentPredefinedRange(
itemName: string
): stringParameters
| Name | Type | Description |
|---|---|---|
| itemName | string | A string value that specifies the component name of the Range Filter or Date Filter dashboard item. |
Returns
| Type | Description |
|---|---|
| string | A string value that is the name of the currently selected predefined range. |
Remarks
Use the GetCurrentPredefinedRange method after the dashboard item loads data. When the Range Filter or Date Filter has no data to display, the GetCurrentPredefinedRange method returns null.
GetCurrentRange(itemName) Method
Returns the currently selected range in the specified Range Filter or Date Filter dashboard item.
Declaration
GetCurrentRange(
itemName: string
): ASPxClientDashboardRangeFilterSelectionParameters
| Name | Type | Description |
|---|---|---|
| itemName | string | A String value that specifies the component name of the Range Filter or Date Filter dashboard item. |
Returns
| Type | Description |
|---|---|
| ASPxClientDashboardRangeFilterSelection | A ASPxClientDashboardRangeFilterSelection object that is the selected range. |
Remarks
Use the GetCurrentRange method after the dashboard item loads data. When the Range Filter or Date Filter has no data to display, the GetCurrentRange method returns null.
GetCurrentSelection(itemName) Method
Returns currently selected elements in the master filter item.
Declaration
GetCurrentSelection(
itemName: string
): ASPxClientDashboardItemDataAxisPointTuple[]Parameters
| Name | Type | Description |
|---|---|---|
| itemName | string | A String that specifies a component name of the master filter item. |
Returns
| Type | Description |
|---|---|
| ASPxClientDashboardItemDataAxisPointTuple[] | An array of ASPxClientDashboardItemDataAxisPointTuple objects that identify currently selected elements. |
GetDashboardControl Method
Gets the DashboardControl object that is the client-side part of the Web Dashboard.
Declaration
GetDashboardControl(): anyReturns
| Type | Description |
|---|---|
| any | A DashboardControl object that is the client-side part of the Web Dashboard. |
GetDashboardId Method
Gets the identifier of the dashboard that is displayed in the ASPxClientDashboard.
Declaration
GetDashboardId(): stringReturns
| Type | Description |
|---|---|
| string | A String value that is the identifier of the dashboard displayed in the |
Remarks
You can obtain the state of the displayed dashboard using the ASPxClientDashboard.GetDashboardState method.
GetDashboardState Method
Gets the current dashboard state.
Declaration
GetDashboardState(): stringReturns
| Type | Description |
|---|---|
| string | A string value that identifies the state of the dashboard displayed in the |
Remarks
To learn more about a dashboard state, see Manage Dashboard State.
GetEntireRange(itemName) Method
Returns the visible range for the specified Range Filter or Date Filter dashboard item.
Declaration
GetEntireRange(
itemName: string
): ASPxClientDashboardRangeFilterSelectionParameters
| Name | Type | Description |
|---|---|---|
| itemName | string | A String value that specifies the component name of the Range Filter or Date Filter dashboard item. |
Returns
| Type | Description |
|---|---|
| ASPxClientDashboardRangeFilterSelection | A ASPxClientDashboardRangeFilterSelection object that is the visible range. |
Remarks
Use the GetEntireRange method after the dashboard item loads data. When the Range Filter or Date Filter has no data to display, the GetEntireRange method returns null.
GetExcelExportOptions Method
Allows you to obtain options related to exporting a dashboard/dashboard item to the Excel format.
Declaration
GetExcelExportOptions(): DashboardExcelExportOptionsReturns
| Type | Description |
|---|---|
| DashboardExcelExportOptions | A DashboardExcelExportOptions object containing options related to exporting a dashboard item to the Excel format. |
GetExportOptions Method
Obsolete. Returns settings that specify parameters affecting how the dashboard is exported.
Declaration
GetExportOptions(): ASPxClientDashboardExportOptionsReturns
| Type | Description |
|---|---|
| ASPxClientDashboardExportOptions | A ASPxClientDashboardExportOptions object containing settings that specify parameters affecting how the dashboard is exported. |
GetImageExportOptions Method
Allows you to obtain options related to exporting a dashboard/dashboard item to an image.
Declaration
GetImageExportOptions(): DashboardImageExportOptionsReturns
| Type | Description |
|---|---|
| DashboardImageExportOptions | A DashboardImageExportOptions object containing options related to exporting a dashboard/dashboard item to an image. |
GetItemData(itemName) Method
Returns the client data for the specified dashboard item.
Declaration
GetItemData(
itemName: string
): ASPxClientDashboardItemDataParameters
| Name | Type | Description |
|---|---|---|
| itemName | string | A string that specifies the component name of the dashboard item. |
Returns
| Type | Description |
|---|---|
| ASPxClientDashboardItemData | An ASPxClientDashboardItemData object that represents multidimensional data visualized in the dashboard item. |
Example
The following example demonstrates how to obtain client data corresponding to a particular visual element using ASPxDashboard‘s client-side API. In this example, the ASPxClientDashboard.ItemClick event is handled to obtain client data and invoke the dxPopup widget with the child dxChart.
In the event handler, the ASPxClientDashboardItemClickEventArgs.GetData method is called to obtain dashboard item’s client data. The ASPxClientDashboardItemClickEventArgs.GetAxisPoint method returns the axis point corresponding to the clicked card while the ASPxClientDashboardItemData.GetSlice method returns the slice of client data by this axis point. To obtain axis points belonging to the “Sparkline” data axis, the ASPxClientDashboardItemDataAxis.GetPoints method is used. Corresponding actual/target values are obtained using the ASPxClientDashboardItemData.GetDeltaValue method.
The dxChart is used to display the detailed chart showing a variation of actual/target values over time.
Note
A complete sample project is available at https://github.com/DevExpress-Examples/how-to-obtain-a-dashboard-items-client-data-in-the-aspnet-dashboard-control-t492284.
function getClientData(args) {
if (args.ItemName == "cardDashboardItem1") {
var clientData = [],
clientDataTable = [],
clickedItemData,
delta;
var sparklineAxis = DashboardDataAxisNames.SparklineAxis,
defaultAxis = DashboardDataAxisNames.Default;
clientData = args.GetData();
clickedPoint = args.GetAxisPoint(defaultAxis);
clickedItemData = clientData.GetSlice(clickedPoint);
delta = args.GetDeltas()[0];
for (var i = 0; i < clickedItemData.GetAxis(sparklineAxis).GetPoints().length; i++) {
var dataTableRow = {},
axisPoint = clickedItemData.GetSlice(clickedItemData.GetAxis(sparklineAxis).GetPoints()[i]);
dataTableRow["Argument"] = clickedItemData.GetAxis(sparklineAxis).GetPoints()[i].GetValue();
if (axisPoint.GetDeltaValue(delta.Id).GetActualValue().GetValue() != null &&
axisPoint.GetDeltaValue(delta.Id).GetTargetValue().GetValue() != null) {
dataTableRow["Actual"] = axisPoint.GetDeltaValue(delta.Id).GetActualValue().GetValue();
dataTableRow["Target"] = axisPoint.GetDeltaValue(delta.Id).GetTargetValue().GetValue();
}
else {
dataTableRow["Actual"] = 0;
dataTableRow["Target"] = 0;
}
clientDataTable.push(dataTableRow);
}
var $chart = $('<div/>');
$chart.dxChart({
height: 500,
dataSource: clientDataTable,
series: [{
valueField: 'Actual', name: 'Actual'
}, {
valueField: 'Target', name: 'Target'
}
],
commonSeriesSettings: {
type: 'splineArea',
argumentField: 'Argument',
ignoreEmptyPoints: true
},
argumentAxis: {
showZero: false,
type: 'discrete'
},
valueAxis: {
showZero: false,
type: 'continuous',
label: { format: 'currency' }
}
});
var popup = $("#myPopup").data("dxPopup");
popup.option('title', clickedPoint.GetValue() + " - Details");
$popupContent = popup.content();
$popupContent.empty();
$popupContent.append($chart);
popup.show();
};
}
function initPopup() {
$("#myPopup").dxPopup({
width: 800, height: 600,
title: "Details",
showCloseButton: true
});
}
GetMaximizedDashboardItemName Method
Returns the name of the maximized dashboard item.
Declaration
GetMaximizedDashboardItemName(): stringReturns
| Type | Description |
|---|---|
| string | A String value that is a maximized dashboard item’s name. |
Remarks
To maximize an item:
- In code, call the MaximizeDashboardItem(itemName) method.
- Click the Maximize button in the dashboard item caption.
To restore an item’s size:
- In code, call the RestoreDashboardItem method.
- Click the Restore button in the dashboard item caption.
Note
Maximize or restore actions re-create the dashboard item and fire all events related to the item life cycle (ItemWidgetCreated and ItemWidgetUpdated).
GetParameters Method
Returns dashboard parameter settings and metadata.
Declaration
GetParameters(): ASPxClientDashboardParametersReturns
| Type | Description |
|---|---|
| ASPxClientDashboardParameters | A ASPxClientDashboardParameters object that is a collection of ASPxClientDashboardParameter objects. |
Remarks
ASPxClientDashboardParameter class objects returned by the GetParameters method allow you to obtain parameter settings such as the parameter type (the ASPxClientDashboardParameter.GetType method), the default parameter value (the ASPxClientDashboardParameter.GetDefaultValue method), the parameter name (the ASPxClientDashboardParameter.GetName method), etc.
The ASPxClientDashboardParameter.GetValues method returns possible parameter values. Use the ASPxClientDashboardParameter.SetValue method to specify the current parameter value.
Example
This example demonstrates how to change dashboard parameter values in the ASPxDashboard control on the client side using the ASPxClientDashboard.GetParameters method.
In this example, parameter values are specified using the ASPxClientDashboardParameter.SetValue method. The ASPxClientDashboard.ShowParametersDialog method is used to invoke the Dashboard Parameters dialog that displays applied parameter values.
Note
A complete sample project is available at https://github.com/DevExpress-Examples/aspxdashboard-how-to-specify-dashboard-parameter-values-on-the-client-side-t495684.
<%@ Page Language="C#" AutoEventWireup="true" CodeBehind="Default.aspx.cs"
Inherits="ASPxDashboard_SetParameterValues.Default" %>
<%@ Register Assembly="DevExpress.Dashboard.v17.1.Web, Version=17.1.2.0, Culture=neutral, PublicKeyToken=b88d1754d700e49a"
Namespace="DevExpress.DashboardWeb" TagPrefix="dx" %>
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
<title></title>
</head>
<body>
<form id="form1" runat="server">
<div id="setParameterValuesButton" style="float: left; margin-left: 150px;"></div>
<div id="showParametersForm" style="float: left; margin-left: 100px;"></div>
<div style="position: absolute; left: 0; right: 0; top:50px; bottom:0;">
<dx:ASPxDashboard ID="ASPxDashboard1" runat="server"
WorkingMode="Viewer"
ClientInstanceName="webViewer"
ClientSideEvents-DashboardEndUpdate="function() { setParameterValues(); }"
Width="100%" Height="100%">
</dx:ASPxDashboard>
</div>
</form>
</body>
</html>
<script type="text/javascript" src="<%= Page.ResolveClientUrl("~/Scripts/ParameterValues.js") %>"></script>
GetPdfExportOptions Method
Allows you to obtain options related to exporting a dashboard/dashboard item to the PDF format.
Declaration
GetPdfExportOptions(): DashboardPdfExportOptionsReturns
| Type | Description |
|---|---|
| DashboardPdfExportOptions | A DashboardPdfExportOptions object containing options related to exporting a dashboard/dashboard item to the PDF format. |
GetSelectedTabPage(tabContainerName) Method
Gets the selected page in the specified tab container.
Declaration
GetSelectedTabPage(
tabContainerName: string
): stringParameters
| Name | Type | Description |
|---|---|---|
| tabContainerName | string | A String object that is the tab container’s componentName property value. |
Returns
| Type | Description |
|---|---|
| string | A String object that is the tab page’s componentName property value. |
GetSelectedTabPageIndex(tabContainerName) Method
Gets the index of the selected page in the specified tab container.
Declaration
GetSelectedTabPageIndex(
tabContainerName: string
): numberParameters
| Name | Type | Description |
|---|---|---|
| tabContainerName | string | A String object that is the tab container’s componentName property value. |
Returns
| Type | Description |
|---|---|
| number | A Int32 object that is the tab page’s index. |
GetWorkingMode Method
Gets the current working mode of the Web Dashboard.
Declaration
GetWorkingMode(): stringReturns
| Type | Description |
|---|---|
| string | A String value that is the working mode of the Web Dashboard. |
Remarks
You can switch between working modes of the Web Dashboard on the client side using the ASPxClientDashboard.SwitchToViewer/ASPxClientDashboard.SwitchToDesigner methods.
To specify the default working mode on the server side, use the ASPxDashboard.WorkingMode property.
HideExportDialog Method
Hides the dialog that allows end-users to export the dashboard/dashboard item.
Declaration
HideExportDialog(): voidHideParametersDialog Method
Closes the Dashboard Parameters dialog.
Declaration
HideParametersDialog(): voidIsDesignMode Method
Declaration
IsDesignMode(): booleanReturns
| Type |
|---|
| boolean |
LoadDashboard(dashboardId) Method
Loads a dashboard with the specified identifier from the dashboard storage.
Declaration
LoadDashboard(
dashboardId: string
): voidParameters
| Name | Type | Description |
|---|---|---|
| dashboardId | string | A string value that specifies the dashboard identifier. |
Remarks
Use the ASPxClientDashboard.SaveDashboard method to save the current dashboard.
Note
To learn more about different methods of loading a dashboard, see Loading a Dashboard.
MaximizeDashboardItem(itemName) Method
Expands the specified dashboard item to the entire dashboard size to examine data in greater detail.
Declaration
MaximizeDashboardItem(
itemName: string
): voidParameters
| Name | Type | Description |
|---|---|---|
| itemName | string | A String object that is the dashboard item component name. |
Remarks
To maximize an item:
- In code, call the MaximizeDashboardItem(itemName) method.
- Click the Maximize button in the dashboard item caption.
To restore an item’s size:
- In code, call the RestoreDashboardItem method.
- Click the Restore button in the dashboard item caption.
Note
Maximize or restore actions re-create the dashboard item and fire all events related to the item life cycle (ItemWidgetCreated and ItemWidgetUpdated).
PerformDataCallback(parameter, onCallback) Method
Sends a callback to the server and generates the server-side ASPxDashboard.CustomDataCallback event, passing it the specified argument.
Declaration
PerformDataCallback(
parameter: string,
onCallback: ASPxClientDataCallback
): voidParameters
| Name | Type | Description |
|---|---|---|
| parameter | string | A string value that represents any information that needs to be sent to the server-side ASPxDashboard.CustomDataCallback event. |
| onCallback | ASPxClientDataCallback | An ASPxClientDataCallback object that represents the JavaScript function which receives the callback data as a parameter. |
Remarks
Use the PerformDataCallback method if you need to asynchronously go to the server and perform some server-side processing using AJAX-based callback technology. You can pass the required information to be collected on the client side as a string of arguments (for instance, in the “Name = Value;” form) using the PerformDataCallback method’s parameter parameter.
The PerformDataCallback method posts back to the server using the callback technology and generates a server-side ASPxDashboard.CustomDataCallback event. So, the necessary server-side actions can be performed in the event’s handler based upon the values of the arguments obtained by parsing the passed information string.
Note
The ASPxClientDashboard.BeginCallback and ASPxClientDashboard.EndCallback client events can also be used to perform necessary client actions before and after callback processing.
PerformDrillDown(itemName, value) Method
Performs a drill-down into the required element by its value.
Declaration
PerformDrillDown(
itemName: string,
value: any | ASPxClientDashboardItemDataAxisPointTuple
): voidParameters
| Name | Type | Description |
|---|---|---|
| itemName | string | A String that species the component name of the dashboard item. |
| value | any | ASPxClientDashboardItemDataAxisPointTuple | A value that will be used to perform a drill-down for the required element. |
PerformDrillUp(itemName) Method
Performs a drill-up for the specified dashboard item.
Declaration
PerformDrillUp(
itemName: string
): voidParameters
| Name | Type | Description |
|---|---|---|
| itemName | string | A String that specifies the component name of the dashboard item. |
Refresh Method
Refreshes an entire dashboard displayed in the Web Dashboard control.
Declaration
Refresh(
itemName?: string | string[]
): voidParameters
| Name | Type |
|---|---|
| itemName | string | string[] |
Remarks
The Refresh method requests the actual state of the dashboard/dashboard item from the web server. For instance, the call of this method returns the actual data from the web or database server.
ReloadData Method
Reloads data in the data sources.
Declaration
ReloadData(): voidRemarks
When the client data processing mode is used, Web Dashboard caches data on the server side to improve data loading performance. When you call the ReloadData method on the client side, a callback is sent to the server. The server-side’s cache for all data sources is reset and all dashboard items request new data from data sources.
Important
Since multiple users can simultaneously open the dashboard and share the same server-side cache, execution of the reloadData method by one of the clients forces the server cache to be reset. All users get new data on the next request to the server.
RequestUnderlyingData(itemName, args, onCompleted) Method
Requests underlying data for the specified dashboard item.
Declaration
RequestUnderlyingData(
itemName: string,
args: ASPxClientDashboardItemRequestUnderlyingDataParameters,
onCompleted: ASPxClientDashboardItemRequestUnderlyingDataCompleted
): voidParameters
| Name | Type | Description |
|---|---|---|
| itemName | string | A string that specifies the component name of the dashboard item. |
| args | ASPxClientDashboardItemRequestUnderlyingDataParameters | A ASPxClientDashboardItemRequestUnderlyingDataParameters object containing parameters used to obtain the underlying data. |
| onCompleted | ASPxClientDashboardItemRequestUnderlyingDataCompleted | A ASPxClientDashboardItemRequestUnderlyingDataCompleted object that references a method executed after the request is completed. |
Remarks
Note that the RequestUnderlyingData method does not return data for calculated fields containing the Aggr function.
The following code snippet shows how to set the method’s parameters to obtain underlying data:
var requestParameters = {
DataMembers: ['ProductName', 'OrderID']
};
Dashboard.RequestUnderlyingData("gaugeDashboardItem1", requestParameters, function(data) {
var dataM = data.GetDataMembers();
for(var i = 0; i < data.GetRowCount(); i++) {
var dataTableRow = {};
$.each(dataM, function(_, dataMember) {
dataTableRow[dataMember] = data.GetRowValue(i, dataMember);
});
underlyingData.push(dataTableRow);
}
})
RestoreDashboardItem Method
Restores the item size if an item is expanded to the entire dashboard size (maximized).
Declaration
RestoreDashboardItem(): voidRemarks
To maximize an item:
- Call the MaximizeDashboardItem(itemName) method in code.
- End-users can click the Maximize button in the dashboard item caption.
To restore an item’s size:
- Call the RestoreDashboardItem method in code.
- End users can click the Restore button in the dashboard item caption.
Note
The dashboard item is re-created when you maximize / restore the item. All events connected with dashboard item life cycle (such as ItemWidgetCreated, ItemWidgetUpdated, etc.) are fired again.
SaveDashboard Method
Saves a current dashboard to the dashboard storage.
Declaration
SaveDashboard(): voidRemarks
Use the ASPxClientDashboard.LoadDashboard method to load a dashboard with the specified identifier.
SetDashboardState(dashboardState) Method
Applies the dashboard state to the loaded dashboard.
Declaration
SetDashboardState(
dashboardState: any | string
): voidParameters
| Name | Type | Description |
|---|---|---|
| dashboardState | any | string | A JSON object that specifies the dashboard state. |
Remarks
The DashboardState class includes states of individual dashboard items (the DashboardState.Items property) and currently selected parameter values (DashboardState.Parameters).
To learn more about a dashboard state, see Manage Dashboard State.
SetExcelExportOptions(options) Method
Allows you to specify options related to exporting a dashboard/dashboard item to the Excel format.
Declaration
SetExcelExportOptions(
options: DashboardExcelExportOptions
): voidParameters
| Name | Type | Description |
|---|---|---|
| options | DashboardExcelExportOptions | A DashboardExcelExportOptions object containing options related to exporting a dashboard item to the Excel format. |
SetExportOptions(options) Method
Obsolete. Specifies settings that configures dashboard export parameters.
Declaration
SetExportOptions(
options: ASPxClientDashboardExportOptions
): voidParameters
| Name | Type | Description |
|---|---|---|
| options | ASPxClientDashboardExportOptions | A ASPxClientDashboardExportOptions object containing settings that specify parameters affecting how the dashboard is exported. |
SetImageExportOptions(options) Method
Allows you to specify options related to exporting a dashboard/dashboard item to an image.
Declaration
SetImageExportOptions(
options: DashboardImageExportOptions
): voidParameters
| Name | Type | Description |
|---|---|---|
| options | DashboardImageExportOptions | A DashboardImageExportOptions object containing options related to exporting a dashboard/dashboard item to an image. |
SetMasterFilter(itemName, values) Method
Selects required elements by their values in the specified master filter item.
Declaration
SetMasterFilter(
itemName: string,
values: object[][] | ASPxClientDashboardItemDataAxisPointTuple[]
): voidParameters
| Name | Type | Description |
|---|---|---|
| itemName | string | A String that specifies the component name of the master filter item. |
| values | object[][] | ASPxClientDashboardItemDataAxisPointTuple[] | Values that will be used to select elements in the master filter item. |
Remarks
Only dimension fields can be a part of the master filter values. To select a row, create a filter with unique values that unambiguously define this row.
Example
The following example demonstrates how to apply master filtering in the Web Dashboard on the client side.
In this example, the ASPxClientDashboard.SetMasterFilter method is used to select required rows in the Grid dashboard item while the ASPxClientDashboard.SetRange method is called to select the required range in the Range Filter dashboard item. These methods are called in the onClick event handler of the dxButton.
Note
A complete sample project is available at https://github.com/DevExpress-Examples/aspxdashboard-how-to-apply-master-filtering-in-code-t490897.
Imports System
Imports System.Collections.Generic
Imports System.Linq
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls
Namespace WebDashboard_SetMasterFilter
Partial Public Class WebForm1
Inherits System.Web.UI.Page
Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
ASPxDashboard1.DashboardXmlPath = Server.MapPath("App_Data/Dashboard.xml")
End Sub
End Class
End Namespace
SetPdfExportOptions(options) Method
Allows you to specify options related to exporting a dashboard/dashboard item to the PDF format.
Declaration
SetPdfExportOptions(
options: DashboardPdfExportOptions
): voidParameters
| Name | Type | Description |
|---|---|---|
| options | DashboardPdfExportOptions | A DashboardPdfExportOptions object containing options related to exporting a dashboard/dashboard item to the PDF format. |
SetPredefinedRange(itemName, dateTimePeriodName) Method
Selects a predefined range in the Range Filter or Date Filter dashboard item.
Declaration
SetPredefinedRange(
itemName: string,
dateTimePeriodName: string
): voidParameters
| Name | Type | Description |
|---|---|---|
| itemName | string | A String value that specifies the component name of the Range Filter or Date Filter. |
| dateTimePeriodName | string | A String value that specifies the predefined range name. |
Remarks
Use the SetPredefinedRange method after the dashboard item loads data. When the Range Filter or Date Filter has no data to display, the SetPredefinedRange method returns null.
SetRange(itemName, range) Method
Selects the required range in the specified Range Filter or Date Filter dashboard item.
Declaration
SetRange(
itemName: string,
range: ASPxClientDashboardRangeFilterSelection
): voidParameters
| Name | Type | Description |
|---|---|---|
| itemName | string | A String that specifies the component name of the Range Filter or Date Filter dashboard item. |
| range | ASPxClientDashboardRangeFilterSelection | A ASPxClientDashboardRangeFilterSelection object that specifies a range to be selected. |
Remarks
Use the SetRange method after the dashboard item loads data. When the Range Filter or Date Filter has no data to display, the SetRange method returns null.
SetSelectedTabPage(tabPageName) Method
Selects the specified tab page by its component name.
Declaration
SetSelectedTabPage(
tabPageName: string
): voidParameters
| Name | Type | Description |
|---|---|---|
| tabPageName | string | A String object that is the tab page’s componentName property value. |
SetSelectedTabPageIndex(tabContainerName, index) Method
Selects the specified tab page by its index in the specified tab container.
Declaration
SetSelectedTabPageIndex(
tabContainerName: string,
index: number
): voidParameters
| Name | Type | Description |
|---|---|---|
| tabContainerName | string | A String object that is the tab container’s componentName property value. |
| index | number | A Int32 object that is the tab page’s index. |
ShowExportDashboardDialog(format) Method
Invokes the dialog that allows end-users to export the entire dashboard to the specified format.
Declaration
ShowExportDashboardDialog(
format: string
): voidParameters
| Name | Type | Description |
|---|---|---|
| format | string | A string value that specifies the format. For instance, you can use ‘PDF’, ‘Image’, or ‘Excel’. |
ShowExportDashboardItemDialog(itemComponentName, format) Method
Invokes the dialog that allows end-users to export the dashboard item to the specified format.
Declaration
ShowExportDashboardItemDialog(
itemComponentName: string,
format: string
): voidParameters
| Name | Type | Description |
|---|---|---|
| itemComponentName | string | A string value that specifies the component name of the dashboard item to export. |
| format | string | A string value that specifies the format. For instance, you can use ‘PDF, ‘Image’ or ‘Excel’. Note that some items (i.e., TextBoxDashboardItem or ImageDashboardItem) do not support exporting to the ‘Excel’ format. |
ShowParametersDialog Method
Invokes the Dashboard Parameters dialog.
Declaration
ShowParametersDialog(): voidSwitchToDesigner Method
Switches the ASPxClientDashboard to the designer mode.
Declaration
SwitchToDesigner(): voidRemarks
Use the ASPxClientDashboard.SwitchToViewer method to switch the ASPxClientDashboard to the viewer mode. You can obtain the current working mode using the ASPxClientDashboard.GetWorkingMode method.
SwitchToViewer Method
Switches the ASPxClientDashboard to the viewer mode.
Declaration
SwitchToViewer(): voidRemarks
Use the ASPxClientDashboard.SwitchToDesigner method to switch the ASPxClientDashboard to the designer mode. You can obtain the current working mode using the ASPxClientDashboard.GetWorkingMode method.
UpdateDashboardTitleToolbar Method
Fires the DashboardTitleToolbarUpdated event.
Declaration
UpdateDashboardTitleToolbar(): voidRemarks
The DashboardTitleToolbarUpdated event occurs before the dashboard title toolbar is updated. Use the UpdateDashboardTitleToolbar method to trigger the following event manually.
UpdateItemCaptionToolbar(itemName) Method
Fires the ItemCaptionToolbarUpdated event for the specified item.
Declaration
UpdateItemCaptionToolbar(
itemName: string
): voidParameters
| Name | Type | Description |
|---|---|---|
| itemName | string | A dashboard item name for which the event is fired. |
Remarks
The ItemCaptionToolbarUpdated event occurs before the dashboard item’s caption toolbar is updated. Use the UpdateItemCaptionToolbar method to trigger the following event manually. If the itemName parameter is empty, the ItemCaptionToolbarUpdated event is fired for all dashboard items and groups.
Events
ActionAvailabilityChanged Event
Occurs after the available interactivity actions have changed for the specific dashboard item.
Declaration
ActionAvailabilityChanged: ASPxClientEvent<ASPxClientActionAvailabilityChangedEventHandler<ASPxClientDashboard>>Event Data
The ActionAvailabilityChanged event's data class is ASPxClientActionAvailabilityChangedEventArgs. The following properties provide information specific to this event:
| Property | Description |
|---|---|
| ItemName | Gets the component name of the dashboard item. |
Example
The following example demonstrates how to perform a drill-down in ASPxDashboard on the client side.
In this example, the ASPxClientDashboard.PerformDrillDown method is used to perform a drill-down for a specified row in a Grid dashboard item. The dxSelectBox widget contains categories for which a drill-down can be performed. These categories are obtained using the ASPxClientDashboard.GetAvailableDrillDownValues method. Select a required category and click the Perform Drill-Down button to perform a drill-down by the selected category.
When the Grid displays a list of products (the bottom-most detail level), you can only perform a drill-up action that returns you to the top detail level. The ASPxClientDashboard.PerformDrillUp method is called to do this.
Note
A complete sample project is available at https://github.com/DevExpress-Examples/aspxdashboard-how-to-perform-a-drill-down-in-code-t495048.
Dim access97Params As New Access97ConnectionParameters()
access97Params.FileName = "..\..\Data\nwind.mdb"
Dim sqlDataSource As New DashboardSqlDataSource("SQL Data Source 1", access97Params)
Dim selectQuery As SelectQuery = SelectQueryFluentBuilder.AddTable("SalesPerson"). _
SelectColumns("CategoryName", "Sales Person", "OrderDate", "Extended Price").Build("Query 1")
sqlDataSource.Queries.Add(selectQuery)
sqlDataSource.Fill()
dashboardDesigner1.Dashboard.DataSources.Add(sqlDataSource)
BeforeRender Event
Occurs before any element in the Web Dashboard control has been rendered.
Declaration
BeforeRender: ASPxClientEvent<ASPxClientDashboardBeforeRenderEventHandler<ASPxClientDashboard>>Event Data
The BeforeRender event's data class is ASPxClientEventArgs.
Remarks
The BeforeRender event allows you to perform client-side customization of the Web Dashboard control before the control and its elements have been rendered. Raise the BeforeRender event and use the ASPxClientDashboard.GetDashboardControl method to get access to the HTML JavaScript dashboard control and its API:
<dx:ASPxDashboard ID="ASPxDashboard1" runat="server">
<ClientSideEvents BeforeRender="onBeforeRender"/>
</dx:ASPxDashboard>
BeginCallback Event
Occurs when a callback for server-side processing is initiated.
Declaration
BeginCallback: ASPxClientEvent<ASPxClientBeginCallbackEventHandler<ASPxClientDashboard>>Event Data
The BeginCallback event's data class is ASPxClientBeginCallbackEventArgs. The following properties provide information specific to this event:
| Property | Description |
|---|---|
| command | Gets a command name that identifies which client action forced a callback to occur. |
Remarks
The BeginCallback and ASPxClientDashboard.EndCallback events can be used to perform specific client-side actions while a callback is being processed on the server side.
Note
Note that BeginCallback and ASPxClientDashboard.EndCallback do not work in ASP.NET MVC Dashboard.
CustomDataCallback Event
Fires when a round trip to the server has been initiated by a call to the client ASPxClientDashboard.PerformDataCallback method.
Declaration
CustomDataCallback: ASPxClientEvent<ASPxClientCustomDataCallbackEventHandler<ASPxClientDashboard>>Event Data
The CustomDataCallback event's data class is ASPxClientCustomDataCallbackEventArgs. The following properties provide information specific to this event:
| Property | Description |
|---|---|
| result | Gets a string that contains specific information (if any) that has been passed from the server to the client side for further processing, related to the CustomCallback event. |
Remarks
The CustomDataCallback event allows any desired server-side processing to be performed, and any resulting required information to be passed to the client for further processing (if needed).
After the CustomDataCallback event has been processed on the server side, a result can be passed back to the client via the CallbackEventArgs.Result property. To receive the result on the client, handle the ASPxClientDashboard.CustomDataCallback event.
DashboardBeginUpdate Event
Occurs when a dashboard update is initiated.
Declaration
DashboardBeginUpdate: ASPxClientEvent<ASPxClientDashboardBeginUpdateEventHandler<ASPxClientDashboard>>Event Data
The DashboardBeginUpdate event's data class is ASPxClientDashboardBeginUpdateEventArgs. The following properties provide information specific to this event:
| Property | Description |
|---|---|
| DashboardId | Gets the identifier of the dashboard for which the event was raised. |
Remarks
After the dashboard update is performed, the ASPxClientDashboard.DashboardEndUpdate event is fired.
DashboardChanged Event
The DashboardChanged client-side event is obsolete. Use the DashboardInitialized event instead.
Declaration
DashboardChanged: ASPxClientEvent<ASPxClientDashboardChangedEventHandler<ASPxClientDashboard>>Event Data
The DashboardChanged event's data class is ASPxClientDashboardChangedEventArgs. The following properties provide information specific to this event:
| Property | Description |
|---|---|
| DashboardId | Gets the identifier of a newly opened dashboard. |
DashboardEndUpdate Event
Occurs after the dashboard update is performed.
Declaration
DashboardEndUpdate: ASPxClientEvent<ASPxClientDashboardEndUpdateEventHandler<ASPxClientDashboard>>Event Data
The DashboardEndUpdate event's data class is ASPxClientDashboardEndUpdateEventArgs. The following properties provide information specific to this event:
| Property | Description |
|---|---|
| DashboardId | Gets the identifier of the dashboard for which the event was raised. |
Remarks
When the dashboard update is initiated, the ASPxClientDashboard.DashboardBeginUpdate event is fired.
DashboardInitialized Event
Occurs after the dashboard displayed in the control has been initialized.
Declaration
DashboardInitialized: ASPxClientEvent<ASPxClientDashboardInitializedEventHandler<ASPxClientDashboard>>Event Data
The DashboardInitialized event's data class is ASPxClientDashboardInitializedEventArgs. The following properties provide information specific to this event:
| Property | Description |
|---|---|
| DashboardId | Gets the dashboard’s unique name. |
Remarks
Use the DashboardId property to get a dashboard’s unique name.
DashboardInitializing Event
Occurs before the dashboard displayed in the control has been initialized.
Declaration
DashboardInitializing: ASPxClientEvent<ASPxClientDashboardInitializingEventHandler<ASPxClientDashboard>>Event Data
The DashboardInitializing event's data class is ASPxClientDashboardInitializingEventArgs. The following properties provide information specific to this event:
| Property | Description |
|---|---|
| Dashboard | Gets a model of the dashboard displayed in the control. |
| DashboardId | Gets a string value that is the dashboard identifier. |
| Ready | Specifies a Promise object to observe when all actions of a certain type bound to the collection, queued or not, have finished. |
DashboardStateChanged Event
Occurs after the current dashboard state in the ASPxClientDashboard is changed.
Declaration
DashboardStateChanged: ASPxClientEvent<ASPxClientDashboardStateChangedEventHandler<ASPxClientDashboard>>Event Data
The DashboardStateChanged event's data class is ASPxClientDashboardStateChangedEventArgs. The following properties provide information specific to this event:
| Property | Description |
|---|---|
| DashboardState | Gets the current state of the dashboard. |
Remarks
To learn more about a dashboard state, see Manage Dashboard State.
Example
The sample illustrates how to save the current ASPxDashboard state (such as master filter or parameter values) to cookies on the client side and restore this state on the server side. The following API is used in this example:
- The ASPxClientDashboard.DashboardStateChanged event is handled to obtain the current dashboard state.
- The ASPxClientUtils.SetCookie client-side method is used to save the dashboard state to cookies.
- In the ASPxDashboard.SetInitialDashboardState event handler, the dashboard state is loaded from the cookies and applied to a dashboard.
Note
A complete sample project is available at https://github.com/DevExpress-Examples/aspxdashboard-how-to-save-a-dashboard-state-to-cookies-t513329.
using DevExpress.DashboardCommon;
using DevExpress.DashboardWeb;
using System;
using System.Web;
namespace WebDashboard_DashboardStateCookies
{
public partial class Default : System.Web.UI.Page
{
protected void Page_Load(object sender, EventArgs e)
{
}
protected void ASPxDashboard1_SetInitialDashboardState(object sender, SetInitialDashboardStateEventArgs e)
{
HttpCookie cookie = Request.Cookies["ASPxDashboardState"];
if (cookie != null)
{
DashboardState dashboardState = new DashboardState();
dashboardState.LoadFromJson(HttpUtility.UrlDecode(cookie.Value));
if (e.DashboardId == "dashboard1")
e.InitialState = dashboardState;
}
}
}
}
DashboardTitleToolbarUpdated Event
Allows you to customize a dashboard title (for instance, add custom buttons, menus, etc.).
Declaration
DashboardTitleToolbarUpdated: ASPxClientEvent<ASPxClientDashboardTitleToolbarUpdatedEventHandler<ASPxClientDashboard>>Event Data
The DashboardTitleToolbarUpdated event's data class is ASPxClientDashboardTitleToolbarUpdatedEventArgs. The following properties provide information specific to this event:
| Property | Description |
|---|---|
| Options | Provides access to dashboard title options. |
Remarks
You can handle the DashboardTitleToolbarUpdated event to customize the dashboard’s title. For instance, you can add custom command buttons, create additional menus, add static texts, etc. The DashboardTitleToolbarOptions class contains options used to customize a dashboard title’s elements (the ViewerToolbarItem objects).
The following code snippet shows how to add a custom button with a drop-down menu to the dashboard’s title. This button belongs to the actionItems collection and is displayed on the right (like the Export To and Parameters buttons).
function onDashboardTitleToolbarUpdated(s, e) {
e.Options.actionItems.push({
text: 'Custom Menu',
type: "menu",
menu: {
type: 'list',
items: ['first', 'second', 'third'],
selectionMode: 'single',
itemClick: function () {
// ...
}
},
})
}
Example
The code snippet below shows how to add a custom command button to a dashboard title by handling ASPxClientDashboard.DashboardTitleToolbarUpdated. In this example, a custom ‘Refresh’ button with the specified SVG icon allows end-users to refresh the entire dashboard. Clicking this button calls the ASPxClientDashboard.Refresh method.
var refreshIcon = '<svg id="refreshIcon" ... /></svg>';
function onBeforeRender(s, e) {
DevExpress.Dashboard.ResourceManager.registerIcon(refreshIcon);
// ...
}
function onDashboardTitleToolbarUpdated(s, e) {
e.Options.actionItems.unshift({
type: "button",
icon: "refreshIcon",
hint: "Refresh Dashboard",
click: function (element) {
clientDashboardDesigner1.Refresh();
}
});
}
DynamicLookUpValuesLoaded Event
Occurs after parameter values provided using a Dynamic List are loaded.
Declaration
DynamicLookUpValuesLoaded: ASPxClientEvent<ASPxClientDynamicLookUpValuesLoadedEventHandler<ASPxClientDashboard>>Event Data
The DynamicLookUpValuesLoaded event's data class is ASPxClientDynamicLookUpValuesLoadedEventArgs. The following properties provide information specific to this event:
| Property | Description |
|---|---|
| ParameterName | Gets the dashboard parameter name whose values have been loaded. |
EndCallback Event
Occurs on the client side after a callback’s server-side processing has been completed.
Declaration
EndCallback: ASPxClientEvent<ASPxClientEndCallbackEventHandler<ASPxClientDashboard>>Event Data
The EndCallback event's data class is ASPxClientEndCallbackEventArgs. The following properties provide information specific to this event:
| Property | Description |
|---|---|
| command | Gets a command name that identifies which client action forced a callback to occur. |
Remarks
The ASPxClientDashboard.BeginCallback and EndCallback events can be used to perform specific client-side actions while a callback is being processed on the server side.
Note
Note that ASPxClientDashboard.BeginCallback and EndCallback do not work in ASP.NET MVC Dashboard.
ItemBeforeWidgetDisposed Event
Allows you to access underlying UI/Data Visualization widgets.
Declaration
ItemBeforeWidgetDisposed: ASPxClientEvent<ASPxClientDashboardItemBeforeWidgetDisposedEventHandler<ASPxClientDashboard>>Event Data
The ItemBeforeWidgetDisposed event's data class is ASPxClientDashboardItemWidgetEventArgs. The following properties provide information specific to this event:
| Property | Description |
|---|---|
| ItemName | Gets the component name of the dashboard item for which the event was raised. |
The event data class exposes the following methods:
| Method | Description |
|---|---|
| GetWidget | Returns an underlying widget corresponding to the current dashboard item. |
ItemBeginUpdate Event
Occurs when a dashboard item update is initiated.
Declaration
ItemBeginUpdate: ASPxClientEvent<ASPxClientItemBeginUpdateEventHandler<ASPxClientDashboard>>Event Data
The ItemBeginUpdate event's data class is ASPxClientItemBeginUpdateEventArgs. The following properties provide information specific to this event:
| Property | Description |
|---|---|
| ItemName | Gets the component name of the dashboard item. |
Remarks
After the dashboard item update is performed, the ASPxClientDashboard.ItemEndUpdate event is fired.
ItemCaptionToolbarUpdated Event
Allows you to customize a dashboard item’s caption (for instance, add custom buttons, menus, etc.).
Declaration
ItemCaptionToolbarUpdated: ASPxClientEvent<ASPxClientDashboardItemCaptionToolbarUpdatedEventHandler<ASPxClientDashboard>>Event Data
The ItemCaptionToolbarUpdated event's data class is ASPxClientDashboardItemCaptionToolbarUpdatedEventArgs. The following properties provide information specific to this event:
| Property | Description |
|---|---|
| ItemName | Gets a component name of the dashboard item. |
| Options | Provides access to caption options of the dashboard item. |
Remarks
You can handle the ItemCaptionToolbarUpdated event to customize the dashboard item’s caption. For instance, you can add custom command buttons, create additional menus, add static texts, etc. The DashboardItemCaptionToolbarOptions class contains options used to customize a dashboard item caption’s elements (the ViewerToolbarItem objects).
The following code snippets show how to add a custom button to the Chart’s caption. This button belongs to the actionItems collection and is displayed only when the mouse pointer hovers over the dashboard item’s caption.
function onItemCaptionToolbarUpdated(s, e) {
if (e.ItemName === "chartDashboardItem1") {
e.Options.actionItems.push({
type: "button",
text: "Custom Button",
click: function () {
// ...
}
});
}
}
ItemClick Event
Occurs when an end-user clicks a dashboard item.
Declaration
ItemClick: ASPxClientEvent<ASPxClientDashboardItemClickEventHandler<ASPxClientDashboard>>Event Data
The ItemClick event's data class is ASPxClientDashboardItemClickEventArgs. The following properties provide information specific to this event:
| Property | Description |
|---|---|
| ItemName | Gets the name of the dashboard item for which the event has been raised. |
The event data class exposes the following methods:
| Method | Description |
|---|---|
| GetAxisPoint(axisName) | Returns the axis point corresponding to the clicked visual element. |
| GetData | Gets the dashboard item’s client data. |
| GetDeltas | Gets deltas corresponding to the clicked visual element. |
| GetDimensions(axisName) | Gets the dimensions used to create a hierarchy of axis points for the specified axis. |
| GetMeasures | Gets measures corresponding to the clicked visual element. |
| RequestUnderlyingData(onCompleted, dataMembers) | Requests underlying data corresponding to the clicked visual element. |
Remarks
Use the ASPxClientDashboardItemClickEventArgs.ItemName event parameter to obtain the dashboard item name for which the event has been raised.
The ASPxClientDashboardItemClickEventArgs.GetAxisPoint allows you to obtain the axis point corresponding to the clicked visual element. Use the ASPxClientDashboardItemClickEventArgs.RequestUnderlyingData method to request the underlying data related to this visual element.
The ASPxClientDashboardItemClickEventArgs.GetData method returns the client data for this dashboard item.
Note
The ItemClick event has the following limitations:
- The ItemClick event is not raised for the following dashboard items: Range Filter, Filter Elements, Text Box, Images.
- the ItemClick event is raised if an end-user clicks a specific visual element within the dashboard item (for instance, a Chart series point or an individual Card). If an end-user click an empty space, the event will not be raised. To learn how to overcome this limitation, see Web Dashboards do not raise the ItemClick event when an end-user clicks an empty space in Chart or Pie items.
ItemDrillDownStateChanged Event
Occurs when a drill-down/drill-up is performed.
Declaration
ItemDrillDownStateChanged: ASPxClientEvent<ASPxClientDashboardItemDrillDownStateChangedEventHandler<ASPxClientDashboard>>Event Data
The ItemDrillDownStateChanged event's data class is ASPxClientDashboardItemDrillDownStateChangedEventArgs. The following properties provide information specific to this event:
| Property | Description |
|---|---|
| Action | Gets the drill-down action performed in the dashboard item. |
| ItemName | Gets the component name of the dashboard item. Inherited from ASPxClientDashboardItemEventArgs. |
| Values | Gets values from the current drill-down hierarchy. |
The event data class exposes the following methods:
| Method | Description |
|---|---|
| IsNullValue(value) | Returns whether the specified value is null. Inherited from ASPxClientDashboardItemEventArgs. |
| IsOthersValue(value) | Returns whether the specified value is ‘others’. Inherited from ASPxClientDashboardItemEventArgs. |
Remarks
The ItemDrillDownStateChanged event is raised when an end-user performs drill-down or drill-up in a certain dashboard item. To determine the component name of this dashboard item, use the ASPxClientDashboardItemEventArgs.ItemName event parameter. Other event parameters include the following.
- ASPxClientDashboardItemDrillDownStateChangedEventArgs.Action returns the action performed in the dashboard item. For example, ‘Down’ identifies a drill-down while ‘Up’ identifies a drill-up.
- ASPxClientDashboardItemDrillDownStateChangedEventArgs.Values returns values from the current drill-down hierarchy. In OLAP mode, the ASPxClientDashboardItemDrillDownStateChangedEventArgs.Values property returns unique names instead of values.
ItemElementCustomColor Event
Allows you to color the required dashboard item elements using the specified colors.
Declaration
ItemElementCustomColor: ASPxClientEvent<ASPxClientDashboardItemElementCustomColorEventHandler<ASPxClientDashboard>>Event Data
The ItemElementCustomColor event's data class is ASPxClientDashboardItemElementCustomColorEventArgs. The following properties provide information specific to this event:
| Property | Description |
|---|---|
| ItemName | Gets the component name of the dashboard item for which the event was raised. |
The event data class exposes the following methods:
| Method | Description |
|---|---|
| GetColor | Gets the color of the current dashboard item element. |
| GetMeasures | Gets measures corresponding to the current dashboard item element. |
| GetTargetElement | Gets the axis point tuple that corresponds to the current dashboard item element. |
| SetColor(color) | Sets the color of the current dashboard item element. |
Remarks
The ItemElementCustomColor event allows you to color the required dashboard item elements (for instance, chart series points, pie segments or scatter chart points) using the specified colors. The ASPxClientDashboardItemElementCustomColorEventArgs class exposes the following settings that allow you to color the required element.
- Use the ASPxClientDashboardItemElementCustomColorEventArgs.ItemName property to obtain the component name of the dashboard item for which the event was raised.
The ASPxClientDashboardItemElementCustomColorEventArgs.GetTargetElement method returns the axis point tuple that corresponds to the current dashboard item element.
The ASPxClientDashboardItemElementCustomColorEventArgs.GetMeasures method returns measures corresponding to the current dashboard item element.
- Use the ASPxClientDashboardItemElementCustomColorEventArgs.SetColor method to set the color of the current dashboard item element.
Note that color modifications applied using the ItemElementCustomColor event are not applied in the resulting exported document.
Note
By default, the Chart dashboard item colors lines (or fills areas) for the Line/Area series types using the color of the first series point. For these lines/areas, the ASPxClientDashboardItemElementCustomColorEventArgs.GetTargetElement method returns a tuple that does not contain the axis point on the DashboardDataAxisNames.ChartArgumentAxis.
ItemEndUpdate Event
Occurs after the dashboard item update is performed.
Declaration
ItemEndUpdate: ASPxClientEvent<ASPxClientItemEndUpdateEventHandler<ASPxClientDashboard>>Event Data
The ItemEndUpdate event's data class is ASPxClientItemEndUpdateEventArgs. The following properties provide information specific to this event:
| Property | Description |
|---|---|
| ItemName | Gets the component name of the dashboard item. |
Remarks
When the dashboard item update is initiated, the ASPxClientDashboard.ItemBeginUpdate event is fired.
ItemMasterFilterStateChanged Event
Occurs when a master filter state is changed.
Declaration
ItemMasterFilterStateChanged: ASPxClientEvent<ASPxClientDashboardItemMasterFilterStateChangedEventHandler<ASPxClientDashboard>>Event Data
The ItemMasterFilterStateChanged event's data class is ASPxClientDashboardItemMasterFilterStateChangedEventArgs. The following properties provide information specific to this event:
| Property | Description |
|---|---|
| ItemName | Gets the component name of the dashboard item. Inherited from ASPxClientDashboardItemEventArgs. |
| Values | Gets the currently selected values. |
The event data class exposes the following methods:
| Method | Description |
|---|---|
| IsNullValue(value) | Returns whether the specified value is null. Inherited from ASPxClientDashboardItemEventArgs. |
| IsOthersValue(value) | Returns whether the specified value is ‘others’. Inherited from ASPxClientDashboardItemEventArgs. |
Remarks
The ItemMasterFilterStateChanged event is raised when an end-user applies or clears master filtering in a certain dashboard item. To determine the component name of this dashboard item, use the ASPxClientDashboardItemEventArgs.ItemName event parameter. The ASPxClientDashboardItemMasterFilterStateChangedEventArgs.Values property returns currently selected values.
Note
For the Range Filter dashboard item, the ASPxClientDashboardItemMasterFilterStateChangedEventArgs.Values property returns the minimum and maximum values in the selected range (these values are JavaScript date instances).
ItemSelectionChanged Event
Occurs after the selection within the dashboard item is changed.
Declaration
ItemSelectionChanged: ASPxClientEvent<ASPxClientDashboardItemSelectionChangedEventHandler<ASPxClientDashboard>>Event Data
The ItemSelectionChanged event's data class is ASPxClientDashboardItemSelectionChangedEventArgs. The following properties provide information specific to this event:
| Property | Description |
|---|---|
| ItemName | Gets the component name of the dashboard item for which the event was raised. |
The event data class exposes the following methods:
| Method | Description |
|---|---|
| GetCurrentSelection | Gets currently selected elements. |
Remarks
The ItemSelectionChanged event is raised after the selection within the dashboard item is changed. The selection can be changed in the following ways:
- the state of master filter item is changed by an end-user or using
ASPxClientDashboard‘s API; - changing the selection within the dashboard item for which a custom visual interactivity is provided (using the ASPxClientDashboard.ItemVisualInteractivity event).
The ASPxClientDashboardItemSelectionChangedEventArgs.ItemName property returns the name of the dashboard item for which the event was raised. Use the ASPxClientDashboardItemSelectionChangedEventArgs.GetCurrentSelection method to obtain the currently selected elements.
Example
The Web Dashboard allows you to add a custom interactivity to dashboards using the ASPxClientDashboard.ItemVisualInteractivity event. This example demonstrates the following capabilities.
- The Grid dashboard item allows you to select categories and visualize a corresponding product quantity using the dxBarGauge widget. Note that the hidden ‘Quantity’ measure is used to pass the required values to the client.
- The Chart dashboard item highlights bars corresponding to a hovered argument value.
Note
A complete sample project is available at https://github.com/DevExpress-Examples/aspxdashboard-how-to-add-custom-interactivity-to-a-dashboard-t495562.
var defaultAxis = DashboardDataAxisNames.DefaultAxis,
argumentAxis = DashboardDataAxisNames.ChartArgumentAxis;
function addCustomInteractivity(args) {
if (args.ItemName == "gridDashboardItem1") {
args.SetTargetAxes([defaultAxis]);
args.SetSelectionMode("Multiple");
}
if (args.ItemName == "chartDashboardItem1") {
args.SetTargetAxes([argumentAxis]);
args.EnableHighlighting(true);
}
}
function createControls() {
$('#barGauge').dxBarGauge({
startValue: 0,
endValue: 10000,
values: getAllValues(),
label: {
format: 'fixedPoint',
precision: 0
}
});
}
function applyCurrentSelection(args) {
var quantityValues = [];
if (args.ItemName == "gridDashboardItem1" & args.GetCurrentSelection().length != 0) {
var clientData = webViewer.GetItemData("gridDashboardItem1");
for (var i = 0; i < args.GetCurrentSelection().length; i++) {
var currentTuple = args.GetCurrentSelection()[i],
slice = clientData.GetSlice(currentTuple.GetAxisPoint()),
quantity = (slice.GetMeasureValue(clientData.GetMeasures()[0].Id)).GetValue();
quantityValues.push(quantity);
}
} else {
quantityValues = getAllValues();
}
$('#barGauge').data("dxBarGauge").values(quantityValues);
}
function getAllValues() {
var quantityValues = [],
clientData = webViewer.GetItemData("gridDashboardItem1");
for (var i = 0; i < clientData.GetAxis(defaultAxis).GetPoints().length; i++) {
var slice = clientData.GetSlice(clientData.GetAxis(defaultAxis).GetPoints()[i]),
quantity = (slice.GetMeasureValue(clientData.GetMeasures()[0].Id)).GetValue();
quantityValues.push(quantity);
}
return quantityValues;
}
ItemVisualInteractivity Event
Allows you to provide custom visual interactivity for data-bound dashboard items that support element selection and highlighting.
Declaration
ItemVisualInteractivity: ASPxClientEvent<ASPxClientDashboardItemVisualInteractivityEventHandler<ASPxClientDashboard>>Event Data
The ItemVisualInteractivity event's data class is ASPxClientDashboardItemVisualInteractivityEventArgs. The following properties provide information specific to this event:
| Property | Description |
|---|---|
| ItemName | Gets the component name of the dashboard item for which the event was raised. |
The event data class exposes the following methods:
| Method | Description |
|---|---|
| EnableHighlighting(enableHighlighting) | Enables highlighting for the current dashboard item. |
| GetDefaultSelection | Gets the default selection for the current dashboard item. |
| GetSelectionMode | Gets the selection mode for dashboard item elements. |
| GetTargetAxes | Gets data axes used to perform custom interactivity actions. |
| IsHighlightingEnabled | Returns whether highlighting is enabled for the current dashboard item. |
| SetDefaultSelection(values) | Sets the default selection for the current dashboard item. |
| SetSelectionMode(selectionMode) | Sets the selection mode for dashboard item elements. |
| SetTargetAxes(targetAxes) | Sets data axes used to perform custom interactivity actions. |
Remarks
The ItemVisualInteractivity event allows you to provide custom visual interactivity for data-bound dashboard items that support element selection and highlighting. This event is raised for dashboard items with disabled master filtering. Visual interactivity is enabled for master filter items by default. The ASPxClientDashboard also fires this event when master filtering is applied to the current dashboard item or drill-down is performed in this dashboard item.
Use the ASPxClientDashboardItemVisualInteractivityEventArgs.ItemName event parameter to obtain the name of the dashboard item for which the event was raised. The ASPxClientDashboardItemVisualInteractivityEventArgs.SetTargetAxes method allows you to specify data axes used to perform custom interactivity actions (selection of grid rows, selection and highlighting of chart series points, etc.).
To specify the selection mode and enable highlighting, use the ASPxClientDashboardItemVisualInteractivityEventArgs.SetSelectionMode and ASPxClientDashboardItemVisualInteractivityEventArgs.EnableHighlighting methods respectively. The ASPxClientDashboardItemVisualInteractivityEventArgs.SetDefaultSelection method provides the capability to specify the default selection for the current dashboard item.
After the selection is changed, the ASPxClientDashboard.ItemSelectionChanged event is raised. Its ASPxClientDashboardItemSelectionChangedEventArgs.GetCurrentSelection method returns the selected elements.
The following table lists possible target axes for each dashboard item and supported interactivity capabilities.
Dashboard Item | Target Axes | Selection | Highlighting |
|---|---|---|---|
| |||
|
| ||
|
| ||
|
| ||
|
| ||
|
| ||
|
| ||
|
|
Note
Note that the Grid dashboard item does not support custom interactivity when Cell Merging is enabled.
ItemWidgetCreated Event
Allows you to access underlying UI/Data Visualization widgets.
Declaration
ItemWidgetCreated: ASPxClientEvent<ASPxClientDashboardItemWidgetCreatedEventHandler<ASPxClientDashboard>>Event Data
The ItemWidgetCreated event's data class is ASPxClientDashboardItemWidgetEventArgs. The following properties provide information specific to this event:
| Property | Description |
|---|---|
| ItemName | Gets the component name of the dashboard item for which the event was raised. |
The event data class exposes the following methods:
| Method | Description |
|---|---|
| GetWidget | Returns an underlying widget corresponding to the current dashboard item. |
Remarks
The Web Dashboard uses DevExtreme widgets to visualize data within dashboard items. The ItemWidgetCreated event allows you to access these widgets and customize their settings if necessary.
The ASPxClientDashboard exposes the following events that allow you to access these widgets and customize their settings.
- The ItemWidgetCreated event is raised once for each widget when the dashboard is loaded to the client. Handle this event to subscribe to events of the client widget.
- ASPxClientDashboard.ItemWidgetUpdating/ASPxClientDashboard.ItemWidgetUpdated events are raised when the client widget needs to be updated. For instance, this can be related to applying master filtering or changing parameter values.
Handle the ASPxClientDashboard.ItemWidgetUpdating event to unsubscribe from events of the client widget. To customize the widget according your requirements, handle the ASPxClientDashboard.ItemWidgetUpdated event. This allows you to prevent the
ASPxClientDashboardfrom rewriting customized options.
Note that the dashboard item is re-created when you maximize / restore the item. All events connected with dashboard item life cycle (such as ItemWidgetCreated, ItemWidgetUpdated, etc.) are fired again.
Note
The ItemWidgetCreated event is not fired for a custom dashboard item.
The ASPxClientDashboardItemWidgetEventArgs.ItemName event parameter returns the component name of the dashboard item whose widget may be customized. Use the ASPxClientDashboardItemWidgetEventArgs.GetWidget method to access the corresponding underlying widget.
The following table lists dashboard items whose underlying widgets may be accessed when handling the ItemWidgetCreated event.
Dashboard Item | Underlying Widget(s) |
|---|---|
an array of dxPieChart widgets | |
an array of dxCircularGauge or dxLinearGauge widgets | |
|
dxTreeView (for v17.1 and earlier) | |
n/a See Note 1 | |
n/a See Note 1 | |
n/a See Note 2 |
1 The content of the TextBoxDashboardItem and the ImageDashboardItem is an HTML element wrapped in a jQuery object.
2 The CustomDashboardItem is a custom widget. You can customize it directly.
ItemWidgetUpdated Event
Allows you to access underlying UI/Data Visualization widgets.
Declaration
ItemWidgetUpdated: ASPxClientEvent<ASPxClientDashboardItemWidgetUpdatedEventHandler<ASPxClientDashboard>>Event Data
The ItemWidgetUpdated event's data class is ASPxClientDashboardItemWidgetEventArgs. The following properties provide information specific to this event:
| Property | Description |
|---|---|
| ItemName | Gets the component name of the dashboard item for which the event was raised. |
The event data class exposes the following methods:
| Method | Description |
|---|---|
| GetWidget | Returns an underlying widget corresponding to the current dashboard item. |
Remarks
The Web Dashboard uses DevExtreme widgets to visualize data within dashboard items. The ItemWidgetUpdated event allows you to access these widgets and customize their settings if necessary.
The ASPxClientDashboard exposes the following events that allow you to access these widgets and customize their settings.
- The ASPxClientDashboard.ItemWidgetCreated event is raised once for each widget when the dashboard is loaded to client. Handle this event to subscribe to events of the client widget.
- ASPxClientDashboard.ItemWidgetUpdating/ItemWidgetUpdated events are raised when the client widget needs to be updated. For instance, this can be related to applying master filtering or changing parameter values.
Handle the ASPxClientDashboard.ItemWidgetUpdating event to unsubscribe from events of the client widget. To customize the widget according your requirements, handle the ItemWidgetUpdated event. This allows you to prevent the
ASPxClientDashboardfrom rewriting customized options.
Note that the dashboard item is re-created when you maximize / restore the item. All events connected with dashboard item life cycle (such as ItemWidgetCreated, ItemWidgetUpdated, etc.) are fired again.
Note
The ItemWidgetUpdated event is not fired for a custom dashboard item.
The ASPxClientDashboardItemWidgetEventArgs.ItemName event parameter returns the component name of the dashboard item whose widget may be customized. Use the ASPxClientDashboardItemWidgetEventArgs.GetWidget method to access the corresponding underlying widget.
The following table lists dashboard items whose underlying widgets may be accessed when handling the ItemWidgetUpdated event.
Dashboard Item | Underlying Widget(s) |
|---|---|
an array of dxPieChart widgets | |
an array of dxCircularGauge or dxLinearGauge widgets | |
|
dxTreeView (for v17.1 and earlier) | |
n/a See Note 1 | |
n/a See Note 1 | |
n/a See Note 2 |
1 The content of the TextBoxDashboardItem and the ImageDashboardItem is an HTML element wrapped in a jQuery object.
2 The CustomDashboardItem is a custom widget. You can customize it directly.
ItemWidgetUpdating Event
Allows you to access underlying UI/Data Visualization widgets.
Declaration
ItemWidgetUpdating: ASPxClientEvent<ASPxClientDashboardItemWidgetUpdatingEventHandler<ASPxClientDashboard>>Event Data
The ItemWidgetUpdating event's data class is ASPxClientDashboardItemWidgetEventArgs. The following properties provide information specific to this event:
| Property | Description |
|---|---|
| ItemName | Gets the component name of the dashboard item for which the event was raised. |
The event data class exposes the following methods:
| Method | Description |
|---|---|
| GetWidget | Returns an underlying widget corresponding to the current dashboard item. |
Remarks
The Web Dashboard uses DevExtreme widgets to visualize data within dashboard items. The ItemWidgetUpdating event allows you to access these widgets and customize their settings if necessary.
The ASPxClientDashboard exposes the following events that allow you to access these widgets and customize their settings.
- The ASPxClientDashboard.ItemWidgetCreated event is raised once for each widget when the dashboard is loaded to client. Handle this event to subscribe to events of the client widget.
- ItemWidgetUpdating/ASPxClientDashboard.ItemWidgetUpdated events are raised when the client widget needs to be updated. For instance, this can be related to applying master filtering or changing parameter values.
Handle the ItemWidgetUpdating event to unsubscribe from events of the client widget. To customize the widget according your requirements, handle the ASPxClientDashboard.ItemWidgetUpdated event. This allows you to prevent the
ASPxClientDashboardfrom rewriting customized options.
Note that the dashboard item is re-created when you maximize / restore the item. All events connected with dashboard item life cycle (such as ItemWidgetCreated, ItemWidgetUpdated, etc.) are fired again.
Note
The ItemWidgetUpdating event is not fired for a custom dashboard item.
The ASPxClientDashboardItemWidgetEventArgs.ItemName event parameter returns the component name of the dashboard item whose widget may be customized. Use the ASPxClientDashboardItemWidgetEventArgs.GetWidget method to access the corresponding underlying widget.
The following table lists dashboard items whose underlying widgets may be accessed when handling the ItemWidgetUpdating event.
Dashboard Item | Underlying Widget(s) |
|---|---|
an array of dxPieChart widgets | |
an array of dxCircularGauge or dxLinearGauge widgets | |
|
dxTreeView (for v17.1 and earlier) | |
n/a See Note 1 | |
n/a See Note 1 | |
n/a See Note 2 |
1 The content of the TextBoxDashboardItem and the ImageDashboardItem is an HTML element wrapped in a jQuery object.
2 The CustomDashboardItem is a custom widget. You can customize it directly.
SelectedTabPageChanged Event
Occurs when the selected tab page is changed.
Declaration
SelectedTabPageChanged: ASPxClientEvent<ASPxClientSelectedTabPageChangedEventHandler<ASPxClientDashboard>>Event Data
The SelectedTabPageChanged event's data class is ASPxClientSelectedTabPageChangedEventArgs. The following properties provide information specific to this event:
| Property | Description |
|---|---|
| PreviousPage | Gets the tab page that was selected. |
| SelectedPage | Gets the tab page that is selected. |
| TabContainerName | Gets the name of the tab container that contains the selected tab page. |