ILifeSpanHandlerOnBeforePopup Method

bool OnBeforePopup(
	IWebBrowser chromiumWebBrowser,
	IBrowser browser,
	IFrame frame,
	string targetUrl,
	string targetFrameName,
	WindowOpenDisposition targetDisposition,
	bool userGesture,
	IPopupFeatures popupFeatures,
	IWindowInfo windowInfo,
	IBrowserSettings browserSettings,
	ref bool noJavascriptAccess,
	out IWebBrowser newBrowser
)

bool OnBeforePopup(
	IWebBrowser^ chromiumWebBrowser, 
	IBrowser^ browser, 
	IFrame^ frame, 
	String^ targetUrl, 
	String^ targetFrameName, 
	WindowOpenDisposition targetDisposition, 
	bool userGesture, 
	IPopupFeatures^ popupFeatures, 
	IWindowInfo^ windowInfo, 
	IBrowserSettings^ browserSettings, 
	bool% noJavascriptAccess, 
	[OutAttribute] IWebBrowser^% newBrowser
)

Parameters

chromiumWebBrowser  IWebBrowser

the ChromiumWebBrowser control

browser  IBrowser

The browser instance that launched this popup.

frame  IFrame

The HTML frame that launched this popup.

targetUrl  String

The URL of the popup content. (This may be empty/null)

targetFrameName  String

The name of the popup. (This may be empty/null)

targetDisposition  WindowOpenDisposition

The value indicates where the user intended to open the popup (e.g. current tab, new tab, etc)

userGesture  Boolean

The value will be true if the popup was opened via explicit user gesture (e.g. clicking a link) or false if the popup opened automatically (e.g. via the DomContentLoaded event).

popupFeatures  IPopupFeatures

structure contains additional information about the requested popup window

windowInfo  IWindowInfo

window information

browserSettings  IBrowserSettings

browser settings, defaults to source browsers

noJavascriptAccess  Boolean

value indicates whether the new browser window should be scriptable and in the same process as the source browser.

newBrowser  IWebBrowser

EXPERIMENTAL - Low level this allows for assigning the CefClient instance associated with the new ChromiumWebBrowser instance to the CefClient param of the CefLifeSpanHandler::OnBeforeBrowser method. This allows for all the handlers, LifeSpanHandler, DisplayHandler, etc to be associated with the CefClient of the new ChromiumWebBrowser instance to be associated with the popup (browser). WPF/WinForms specific code is still required to host the popup (browser) in the new ChromiumWebBrowser instance. Set to null for default behaviour. If you return true (cancel popup creation) then his property **MUST** be null, an exception will be thrown otherwise.

Return Value

Reference