Dashboard.OptionsChanged Event

Occurs after any option in the current Dashboard is changed.

Namespace: DevExpress.DashboardCommon

Assembly: DevExpress.Dashboard.v20.2.Core.dll

NuGet Packages: DevExpress.Dashboard.Core, DevExpress.WindowsDesktop.Dashboard.Core

Declaration

C#

public event DashboardOptionsChangedEventHandler OptionsChanged

VB.NET

Public Event OptionsChanged As DashboardOptionsChangedEventHandler

Event Data

The OptionsChanged event's data class is DashboardOptionsChangedEventArgs.

Remarks

The event occurs after any action is added to dashboard history and fires only for the current dashboard.

In the UI, when you use the Open command, the dashboard instance remains the same and the OptionsChanged event continues to occur for the opened dashboard. The New command creates a new dashboard instance and you need to handle the OptionsChanged event again.

To detect changes for any dashboard, fire the designer’s DashboardDesigner.DashboardOptionsChanged event. You can also use the DashboardDesigner.IsDashboardModified property to indicate changes made in the DashboardDesigner UI since the last save.

The example below shows how to handle the OptionsChanged event to check the actual dashboard state.

C#

dashboardDesigner1.Dashboard.OptionsChanged += Dashboard_OptionsChanged;  

private void Dashboard_OptionsChanged(object sender, DashboardOptionsChangedEventArgs e) {  
    this.BeginInvoke((Action)(() => {  
        bool hasUndo = undoBarItem1.Enabled;  
        bool hasRedo = redoBarItem1.Enabled;  
        Debug.WriteLine($"Undo = {hasUndo}, Redo = {hasRedo}");  
    }));  
} 

VB.NET

Private dashboardDesigner1.Dashboard.OptionsChanged += Dashboard_OptionsChanged

Private Sub Dashboard_OptionsChanged(ByVal sender As Object, ByVal e As DashboardOptionsChangedEventArgs)
    Me.BeginInvoke(CType(Function() AnonymousMethod1(), Action))
End Sub

Private Function AnonymousMethod1() As Boolean
    Dim hasUndo As Boolean = undoBarItem1.Enabled
    Dim hasRedo As Boolean = redoBarItem1.Enabled
    Debug.WriteLine($"Undo = {hasUndo}, Redo = {hasRedo}")
    Return True
End Function