FileDownload event

Fires to indicate that a file download is about to occur. If a file download dialog box can be displayed, this event fires prior to the appearance of the dialog box.

Syntax

HTML Attribute <element FileDownload = "handler(event)">
attachEvent Method object.attachEvent("FileDownload", handler)

 

Event information

Synchronous No
Bubbles No
Cancelable No

 

Event handler parameters

ActiveDocument [in]

Type: VARIANT_BOOL

A VT_BOOL that specifies whether the file is an Active Document.

VARIANT_FALSE (false)

The file is not an Active Document.

VARIANT_TRUE (true)

The file is an Active Document.

Cancel [in, out, ref]

Type: VARIANT_BOOL

A VT_BOOL that specifies whether to continue the download process and display the download dialog box.

VARIANT_FALSE (false)

Default. Continue with the download process and display download dialog box.

VARIANT_TRUE (true)

Cancel the download process.

Remarks

This event enables the user to take an alternative action during a file download.