Skip to main content

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

public event DashboardCreatingEventHandler DashboardCreating

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.

See Also