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

Occurs when an IWebView creates a new child web-view instance (usually the result of window.open or an external link). It is your responsibility to display this child web-view in your application.

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

Syntax

C#
public event ShowCreatedWebViewEventHandler ShowCreatedWebView
Visual Basic
Public Event ShowCreatedWebView As ShowCreatedWebViewEventHandler
Visual C++
public:
virtual  event ShowCreatedWebViewEventHandler^ ShowCreatedWebView {
	void add (ShowCreatedWebViewEventHandler^ value);
	void remove (ShowCreatedWebViewEventHandler^ value);
}

Implements

IWebView..::..ShowCreatedWebView

Remarks

ShowCreatedWebView occurs when an IWebView instance creates a new child view (usually the result of window.open or an external link).

It is your responsibility to wrap and display this new view in your application. WebView provides a constructor that accepts a previously created web-view instance. (see WebView(IntPtr)). Similarly, technology specific WebControls provide a NativeView property that allows you to assign to the controls, a previously created web-view instance (eg, NativeView). This property should be set before the control loads and creates its own underlying web-view. Usually immediately after instantiating the control or in the designer.

Caution
If you do not intend to wrap the new view, you should set Cancel to true, to tell the core to destroy the unused web-view instance. If you fail to do this, the native web-view instance will remain alive until the WebCore is shut down. This can result in many processes (awesomium_process) being spawned, but never used.

The WebCore provides a DestroyUnwrappedViews()()()() method. This can be useful for destroying such native views that were spawned by Awesomium, but were never wrapped.

Note
If you are wrapping the child view using a WebView instance, you should call Resize(Int32, Int32) on the child view immediately after the ShowCreatedWebView event, to make it match your container.

See Also