TdxBackendFormNotifyEvent Type

The procedural type for dialog-related events in ExpressDashboards and ExpressReports.

Declaration

TdxBackendFormNotifyEvent = procedure(ASender: TObject; AForm: TForm) of object;

Parameters

Name	Type	Description
ASender	TObject	Provides access to the component that raised the dialog-related event. You need to cast the Sender parameter value to one of the following classes (depending on the actual parent component type) to access all public API members: TdxDashboard TdxDashboardControl TdxReport TdxReportControl Tip You can call the Sender.ClassType function or use other RTTI functionality to identify the actual parent component type.
AForm	TForm	Provides access to the target dialog form. You can customize any dialog form settings (for example, change caption, dimensions, and position).

Remarks

Dialog form-related events allow you to customize end-user dialogs in ExpressDashboards and ExpressReports-powered applications.

Code Example: Modify Dashboard Designer Form Settings

The following code example demonstrates an OnViewerFormShow event handler that modifies caption, dimensions, and position of the Dashboard Viewer dialog when it is displayed:

Delphi

uses
  dxDashboard.Control;  // Declares the TdxDashboardControl class
//...

procedure TMyForm.dxDashboardControl1ViewerFormShow(ASender: TObject; AForm: TForm);
begin
  AForm.Caption := 'My Dashboard Viewer';  // Changes the Dashboard Viewer form caption
  AForm.WindowState := wsNormal;             // Switches from maximized to the normal form state
  AForm.Position := poScreenCenter;          // Centers the dialog on the screen
  AForm.Width := 1200;                       // Specifies the dialog width
  AForm.Height := 800;                       // Specifies the dialog height
end;

C++

#include "dxDashboard.Control.hpp"  // Declares the TdxDashboardControl class

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

void __fastcall TMyForm::dxDashboardControl1ViewerFormShow(TObject *ASender, TForm *AForm)
{
  AForm->Caption = "My Dashboard Viewer";  // Changes the Dashboard Viewer form caption
  AForm->WindowState = wsNormal;             // Switches from maximized to the normal form state
  AForm->Position = poScreenCenter;          // Centers the dialog on the screen
  AForm->Width = 1200;                       // Specifies the dialog width
  AForm->Height = 800;                       // Specifies the dialog height
}

Direct TdxBackendFormNotifyEvent Type References

The following events reference the TdxBackendFormNotifyEvent procedural type:

Dashboard Container

TdxDashboard.OnDesignerFormShow

Allows you to customize Dashboard Designer dialog form settings.

TdxDashboard.OnViewerFormShow

Allows you to customize Dashboard Designer dialog form settings.

Dashboard Control

TdxCustomDashboardControl.OnDesignerFormShow

Allows you to customize Dashboard Designer dialog form settings.

TdxCustomDashboardControl.OnViewerFormShow

Allows you to customize Dashboard Viewer dialog form settings.

Report Component

TdxReport.OnDesignerFormShow

Allows you to customize Report Designer dialog form settings.

TdxReport.OnViewerFormShow

Allows you to customize Report Viewer dialog form settings.

Report Control

TdxCustomReportControl.OnDesignerFormShow

Allows you to customize Report Designer dialog form settings.

TdxCustomReportControl.OnViewerFormShow

Allows you to customize Report Viewer dialog form settings.