Click or drag to resize
CfxBrowserProcessHandler Class

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

Structure used to implement browser process callbacks. The functions of this structure will be called on the browser process main thread unless otherwise indicated.
Inheritance Hierarchy
SystemObject
  ChromiumCfxObject
    ChromiumCfxBase
      ChromiumCfxClientBase
        ChromiumCfxBrowserProcessHandler

Namespace: Chromium
Assembly: ChromiumFX (in ChromiumFX.dll)
Syntax
public class CfxBrowserProcessHandler : CfxClientBase

The CfxBrowserProcessHandler type exposes the following members.

Constructors
  NameDescription
Public methodCfxBrowserProcessHandler
Initializes a new instance of the CfxBrowserProcessHandler class
Top
Properties
  NameDescription
Public propertyCallbacksDisabled
When true, all CEF callback events are disabled for this handler. Incoming callbacks will return default values to CEF.
(Inherited from CfxClientBase.)
Public propertyNativePtr
Provides access to the underlying native cef struct. This is a refcounted client struct derived from cef_base_t. Add a ref in order to keep it alive when this managed object go out of scope.
(Inherited from CfxClientBase.)
Top
Methods
  NameDescription
Public methodRetrievePrintHandler
Retrieves the CfxPrintHandler provided by the event handler attached to the GetPrintHandler event, if any. Returns null if no event handler is attached.
Top
Events
  NameDescription
Public eventGetPrintHandler
Return the handler for printing on Linux. If a print handler is not provided then printing will not be supported on the Linux platform.
Public eventOnBeforeChildProcessLaunch
Called before a child process is launched. Will be called on the browser process UI thread when launching a render process and on the browser process IO thread when launching a GPU or plugin process. Provides an opportunity to modify the child process command line. Do not keep a reference to |CommandLine| outside of this function.
Public eventOnContextInitialized
Called on the browser process UI thread immediately after the CEF context has been initialized.
Public eventOnRenderProcessThreadCreated
Called on the browser process IO thread after the main thread has been created for a new render process. Provides an opportunity to specify extra information that will be passed to CfxRenderProcessHandler.OnRenderThreadCreated() in the render process. Do not keep a reference to |ExtraInfo| outside of this function.
Public eventOnScheduleMessagePumpWork
Called from any thread when work has been scheduled for the browser process main (UI) thread. This callback is used in combination with CfxSettings. external_message_pump and cef_do_message_loop_work() in cases where the CEF message loop must be integrated into an existing application message loop (see additional comments and warnings on CfxDoMessageLoopWork). This callback should schedule a cef_do_message_loop_work() call to happen on the main (UI) thread. |DelayMs| is the requested delay in milliseconds. If |DelayMs| is <= 0 then the call should happen reasonably soon. If |DelayMs| is > 0 then the call should be scheduled to happen after the specified delay and any currently pending scheduled call should be cancelled.
Top
Remarks
See also the original CEF documentation in cef/include/capi/cef_browser_process_handler_capi.h.
See Also