Click or drag to resize
CfxRenderProcessHandler Class

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

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

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

The CfxRenderProcessHandler type exposes the following members.

Constructors
  NameDescription
Public methodCfxRenderProcessHandler
Initializes a new instance of the CfxRenderProcessHandler 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 methodRetrieveLoadHandler
Retrieves the CfxLoadHandler provided by the event handler attached to the GetLoadHandler event, if any. Returns null if no event handler is attached.
Top
Events
  NameDescription
Public eventGetLoadHandler
Return the handler for browser load status events.
Public eventOnBeforeNavigation
Called before browser navigation. Return true (1) to cancel the navigation or false (0) to allow the navigation to proceed. The |Request| object cannot be modified in this callback.
Public eventOnBrowserCreated
Called after a browser has been created. When browsing cross-origin a new browser will be created before the old browser with the same identifier is destroyed.
Public eventOnBrowserDestroyed
Called before a browser is destroyed.
Public eventOnContextCreated
Called immediately after the V8 context for a frame has been created. To retrieve the JavaScript 'window' object use the CfxV8Context.GetGlobal() function. V8 handles can only be accessed from the thread on which they are created. A task runner for posting tasks on the associated thread can be retrieved via the CfxV8Context.GetTaskRunner() function.
Public eventOnContextReleased
Called immediately before the V8 context for a frame is released. No references to the context should be kept after this function is called.
Public eventOnFocusedNodeChanged
Called when a new node in the the browser gets focus. The |Node| value may be NULL if no specific node has gained focus. The node object passed to this function represents a snapshot of the DOM at the time this function is executed. DOM objects are only valid for the scope of this function. Do not keep references to or attempt to access any DOM objects outside the scope of this function.
Public eventOnProcessMessageReceived
Called when a new message is received from a different process. Return true (1) if the message was handled or false (0) otherwise. Do not keep a reference to or attempt to access the message outside of this callback.
Public eventOnRenderThreadCreated
Called after the render process main thread has been created. |ExtraInfo| is a read-only value originating from CfxBrowserProcessHandler.OnRenderProcessThreadCreated(). Do not keep a reference to |ExtraInfo| outside of this function.
Public eventOnUncaughtException
Called for global uncaught exceptions in a frame. Execution of this callback is disabled by default. To enable set CfxSettings.UncaughtExceptionStackSize > 0.
Public eventOnWebKitInitialized
Called after WebKit has been initialized.
Top
Remarks
See also the original CEF documentation in cef/include/capi/cef_render_process_handler_capi.h.
See Also