Click or drag to resize
CfxOnBeforePopupEventArgs Class

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

Called on the IO thread before a new popup browser is created. The |Browser| and |Frame| values represent the source of the popup request. The |TargetUrl| and |TargetFrameName| values indicate where the popup browser should navigate and may be NULL if not specified with the request. The |TargetDisposition| value indicates where the user intended to open the popup (e.g. current tab, new tab, etc). The |UserGesture| value will be true (1) if the popup was opened via explicit user gesture (e.g. clicking a link) or false (0) if the popup opened automatically (e.g. via the DomContentLoaded event). The |PopupFeatures| structure contains additional information about the requested popup window. To allow creation of the popup browser optionally modify |WindowInfo|, |Client|, |Settings| and |NoJavascriptAccess| and return false (0). To cancel creation of the popup browser return true (1). The |Client| and |Settings| values will default to the source browser's values. If the |NoJavascriptAccess| value is set to false (0) the new browser will not be scriptable and may not be hosted in the same renderer process as the source browser. Any modifications to |WindowInfo| will be ignored if the parent browser is wrapped in a CfxBrowserView.
Inheritance Hierarchy
SystemObject
  SystemEventArgs
    ChromiumCfxEventArgs
      Chromium.EventCfxOnBeforePopupEventArgs

Namespace: Chromium.Event
Assembly: ChromiumFX (in ChromiumFX.dll)
Syntax
public class CfxOnBeforePopupEventArgs : CfxEventArgs

The CfxOnBeforePopupEventArgs type exposes the following members.

Properties
  NameDescription
Public propertyBrowser
Get the Browser parameter for the OnBeforePopup callback.
Public propertyClient
Set the Client out parameter for the OnBeforePopup callback.
Public propertyFrame
Get the Frame parameter for the OnBeforePopup callback.
Public propertyNoJavascriptAccess
Set the NoJavascriptAccess out parameter for the OnBeforePopup callback.
Public propertyPopupFeatures
Get the PopupFeatures parameter for the OnBeforePopup callback.
Public propertySettings
Get the Settings parameter for the OnBeforePopup callback.
Public propertyTargetDisposition
Get the TargetDisposition parameter for the OnBeforePopup callback.
Public propertyTargetFrameName
Get the TargetFrameName parameter for the OnBeforePopup callback.
Public propertyTargetUrl
Get the TargetUrl parameter for the OnBeforePopup callback.
Public propertyUserGesture
Get the UserGesture parameter for the OnBeforePopup callback.
Public propertyWindowInfo
Get the WindowInfo parameter for the OnBeforePopup callback.
Top
Methods
  NameDescription
Public methodSetReturnValue
Set the return value for the OnBeforePopup callback. Calling SetReturnValue() more then once per callback or from different event handlers will cause an exception to be thrown.
Top
Remarks
See also the original CEF documentation in cef/include/capi/cef_life_span_handler_capi.h.
See Also