TdxDashboard.OnLayoutChanged Event

Allows you to save dashboard layout changes made in the Dashboard Designer dialog.

Declaration

property OnLayoutChanged: TdxDashboardNotifyEvent read; write;

Remarks

Handle the OnLayoutChanged event to execute custom code in response to dashboard layout updates.

Event Occurrence

The OnLayoutChanged event occurs every time a user modifies the current dashboard layout using the Dashboard Designer dialog.

Event Parameter

The ASender parameter provides access to the TdxDashboard container that raised the OnLayoutChanged event.

Code Example: Save Dashboard Layout to File on Every Change

The following code example saves the current Dashboard layout to a file in the XML format every time a user saves pending changes in the Dashboard Designer dialog:

Delphi

uses
  dxDashboard;  // Declares the TdxDashboard class
// ...

procedure TMyForm.dxDashboard1LayoutChanged(ASender: TdxDashboard);
begin
  ASender.Layout.SaveToFile(ASender.Name + '.xml');
end;

C++

#include "dxDashboard.hpp"  // Declares the TdxDashboard class

// Add the following linker directive to the corresponding CPP source file:
#pragma link "dxDashboard"  // Required to use dxDashboard.hpp declarations
// ...

void __fastcall TMyForm::dxDashboard1LayoutChanged(TdxDashboard *ASender)
{
  ASender->Layout->SaveToFile(ASender->Name + ".xml");
}