[This is preliminary documentation and is subject to change.]

Occurs when the page requests to begin downloading a certain file.

Namespace: Awesomium.Windows.Controls
Assembly: Awesomium.Windows.Controls (in Awesomium.Windows.Controls.dll) Version: (


public event DownloadEventHandler Download
Visual Basic
Public Event Download As DownloadEventHandler
Visual C++
virtual  event DownloadEventHandler^ Download {
	void add (DownloadEventHandler^ value);
	void remove (DownloadEventHandler^ value);




The table below presents the way the SelectLocalFiles event is handled, when Handled is set to Default (default):
Wrapper Behavior
WebView If Handled is set to Default (default), the event is immediately canceled.
Technology specific WebControls. If Handled is set to Default (default), controls will display their predefined dialog.
Applications can handle the SelectLocalFiles and Download events either modally or non-modally. Only modal handling is officially supported by Awesomium.NET.

The table below shows the methods of handling the SelectLocalFiles and Download events:

Setting Handling
Modal Developers should provide a response through the SelectedFiles or SelectedFile property, before the event handler exits.
NotModal (Not officially supported by Awesomium.NET) No response will be provided for the request. Developers should later provide a response themselves using either:
This technique is not officially supported by Awesomium.NET. Therefore, the member above is not directly available through the predefined IWebView wrappers. You will have to cast the wrapper to IWebView, to access this member.
For SelectLocalFiles, if you set Handled to NotModal, you should make sure that you always call DidChooseFiles(array<String>[]()[][], Boolean) providing a response to the event. No new SelectLocalFiles events will occur, until a response has been provided for the last one.
Note that Cancel always takes precedence over Handled. If Cancel is set to true, the request will be canceled immediately and the value of Handled (or any other member), is ignored.

See Also