DashboardDesigner.DashboardCreating Event

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

Namespace: DevExpress.DashboardWin

Assembly: DevExpress.Dashboard.v24.1.Win.dll

NuGet Package: DevExpress.Win.Dashboard

Declaration

C#

public event DashboardCreatingEventHandler DashboardCreating

VB.NET

Public Event DashboardCreating As DashboardCreatingEventHandler

Event Data

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

Property	Description
Dashboard	Gets the created dashboard.
Handled	Gets 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.