Click or drag to resize

LifeSpanHandlerOnBeforePopup Method

Version 101.0.180
Called before a popup window is created.

Namespace:  CefSharp.Handler
Assembly:  CefSharp (in CefSharp.dll) Version: 101.0.180.0 (101.0.180.0)
Syntax
Copy
protected virtual 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
)

Parameters

chromiumWebBrowser
Type: CefSharpIWebBrowser
the ChromiumWebBrowser control
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