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

Gets or sets if this event is handled by an application.

Namespace: Awesomium.Core
Assembly: Awesomium.Core (in Awesomium.Core.dll) Version: 1.7.0.3 (1.7.0.3)

Syntax

C#
public EventHandling Handled { get; set; }
Visual Basic
Public Property Handled As EventHandling
	Get
	Set
Visual C++
public:
property EventHandling Handled {
	EventHandling get ();
	void set (EventHandling value);
}

Remarks

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:
Caution
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.
Caution
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
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