Back to Devexpress

DashboardDesigner.DashboardCreating Event

dashboard-devexpress-dot-dashboardwin-dot-dashboarddesigner-b4f50307.md

latest3.0 KB
Original Source

DashboardDesigner.DashboardCreating Event

Allows you to customize a dashboard when it is being created.

Namespace : DevExpress.DashboardWin

Assembly : DevExpress.Dashboard.v25.2.Win.dll

NuGet Package : DevExpress.Win.Dashboard

Declaration

csharp
public event DashboardCreatingEventHandler DashboardCreating
vb
Public Event DashboardCreating As DashboardCreatingEventHandler

Event Data

The DashboardCreating event's data class is DashboardCreatingEventArgs. The following properties provide information specific to this event:

PropertyDescription
DashboardGets the created dashboard.
HandledGets or sets whether the dashboard has been initialized.

Remarks

The DashboardCreating event is raised when an end-user clicks the New button. Handle this event to manually initialize a new dashboard and skip the Data Source wizard.

Before the event is raised, a new Dashboard instance is created via the default Dashboard constructor. This instance is passed in the event parameter’s DashboardCreatingEventArgs.Dashboard property. Use this property to access the dashboard and customize it.

To suppress the default dashboard creation routine, set the DashboardCreatingEventArgs.Handled property to true. Otherwise, the Data Source wizard will be invoked.

When an end-user opens or saves a dashboard, the DashboardDesigner raises the DashboardDesigner.DashboardOpening or DashboardDesigner.DashboardSaving event respectively.

See Also

DashboardDesigner Class

DashboardDesigner Members

DevExpress.DashboardWin Namespace