Click or drag to resize
ILifeSpanHandlerOnBeforePopup Method
Version 63.0.0
Called before a popup window is created.

Namespace: CefSharp
Assembly: CefSharp (in CefSharp.dll) Version: 63.0.0.0 (63.0.0.0)
Syntax
Copy
bool OnBeforePopup(
	IWebBrowser browserControl,
	IBrowser browser,
	IFrame frame,
	string targetUrl,
	string targetFrameName,
	WindowOpenDisposition targetDisposition,
	bool userGesture,
	IPopupFeatures popupFeatures,
	IWindowInfo windowInfo,
	IBrowserSettings browserSettings,
	ref bool noJavascriptAccess,
	out IWebBrowser newBrowser
)

Parameters

browserControl
Type: CefSharpIWebBrowser
The IWebBrowser control this request is for.
browser
Type: CefSharpIBrowser
The browser instance that launched this popup.
frame
Type: CefSharpIFrame
The HTML frame that launched this popup.
targetUrl
Type: SystemString
The URL of the popup content. (This may be empty/null)
targetFrameName
Type: SystemString
The name of the popup. (This may be empty/null)
targetDisposition
Type: CefSharpWindowOpenDisposition
The value indicates where the user intended to open the popup (e.g. current tab, new tab, etc)
userGesture
Type: SystemBoolean
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
Type: CefSharpIPopupFeatures
structure contains additional information about the requested popup window
windowInfo
Type: CefSharpIWindowInfo
window information
browserSettings
Type: CefSharpIBrowserSettings
browser settings, defaults to source browsers
noJavascriptAccess
Type: SystemBoolean
value indicates whether the new browser window should be scriptable and in the same process as the source browser.
newBrowser
Type: CefSharpIWebBrowser
EXPERIMENTAL - A newly created browser that will host the popup. Set to null for default behaviour.

Return Value

Type: Boolean
To cancel creation of the popup window return true otherwise return false.
Remarks
CEF documentation: Called on the IO thread before a new popup window is created. The |browser| and |frame| parameters represent the source of the popup request. The |target_url| and |target_frame_name| values may be empty if none were specified with the request. The |popupFeatures| structure contains information about the requested popup window. To allow creation of the popup window optionally modify |windowInfo|, |client|, |settings| and |no_javascript_access| and return false. To cancel creation of the popup window return true. The |client| and |settings| values will default to the source browser's values. The |no_javascript_access| value indicates whether the new browser window should be scriptable and in the same process as the source browser.
See Also