TdxCustomReportControl.OnViewerFormShow Event

Allows you to customize Report Viewer dialog form settings.

Declaration

property OnViewerFormShow: TdxBackendFormNotifyEvent read; write;

Remarks

Handle OnDesignerFormShow and OnViewerFormShow events to customize Report Designer and Report Viewer dialogs when displayed. You can change caption, dimensions, position, and other settings as demonstrated in the following code example: Modify Report Viewer Form Settings.

Event Occurrence

The ShowViewer procedure raises the OnViewerFormShow event.

Event Parameters

The following parameters are available within an OnViewerFormShow event handler:

ASender

Provides access to the TdxReportControl component that raised the OnViewerFormShow event.

Tip

Cast the returned object (TObject) to the TdxReportControl class to access all public API members.

AForm

Provides access to the Report Viewer dialog form. You can use this parameter to customize any dialog form settings.

Refer to the TdxBackendFormNotifyEvent procedural type description for detailed information on parameters accessible within an OnViewerFormShow event handler.

Code Example: Modify Report Viewer Form Settings

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

Delphi

uses
  dxReport.Control;  // Declares the TdxReportControl class
//...

procedure TMyForm.dxReportControl1ViewerFormShow(ASender: TObject; AForm: TForm);
begin
  AForm.Caption := 'My Report Viewer';  // Changes the Report 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 "dxReport.Control.hpp"  // Declares the TdxReportControl class

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

void __fastcall TMyForm::dxReportControl1ViewerFormShow(TObject *ASender, TForm *AForm)
{
  AForm->Caption = "My Report Viewer";  // Changes the Report 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
}