TdxReport.OnBrowserFileDownload Event

Allows you to modify the report download target in the Report Viewer dialog or prevent users from downloading a report.

Declaration

property OnBrowserFileDownload: TdxReportBrowserFileDownloadEvent read; write;

Remarks

Handle the OnBrowserFileDownload event to execute custom code in response to a report download operation, modify the preview download target, replace the built-in Save As dialog, or prevent the operation depending on specific conditions in your application.

Event Occurrence

The OnBrowserFileDownload event occurs every time a user attempts to export a report in the Report Viewer dialog (in any available format). If the OnBrowserFileDownload event is unhandled, all export commands display the Save As dialog.

Event Parameters

The following parameters are available within an OnBrowserFileDownload event handler:

ASender

Provides access to the TdxReport component that raised the OnBrowserFileDownloaded event.

AFileName

Specifies the full absolute or relative path to the report download target.

You can assign a path to the target file to this parameter.

ACancelDownload

Specifies if the download operation is canceled. Assign True to this parameter within an OnBrowserFileDownload event handler to prevent users from downloading a report file.