// Copyright © 2015 The CefSharp Authors. All rights reserved.
|
//
|
// Use of this source code is governed by a BSD-style license that can be found in the LICENSE file.
|
|
namespace CefSharp
|
{
|
/// <summary>
|
/// Messages sent by the render process can be handled by implementing this
|
/// interface.
|
/// </summary>
|
public interface IRenderProcessMessageHandler
|
{
|
/// <summary>
|
/// OnContextCreated is called in the Render process immediately after a CefV8Context is created.
|
/// An IPC message is immediately sent to notify the context has been created (should be safe to execute javascript).
|
/// If the page has no javascript then no V8Context will be created and as a result this method will not be called.
|
/// Called for every V8Context. To determine if V8Context is from Main frame check <see cref="IFrame.IsMain"/>
|
/// </summary>
|
/// <param name="chromiumWebBrowser">The ChromiumWebBrowser control</param>
|
/// <param name="browser">The browser object</param>
|
/// <param name="frame">The frame.</param>
|
void OnContextCreated(IWebBrowser chromiumWebBrowser, IBrowser browser, IFrame frame);
|
|
/// <summary>
|
/// OnContextReleased is called in the Render process immediately before the CefV8Context is released.
|
/// An IPC message is immediately sent to notify the context has been released (cannot execute javascript this point).
|
/// If the page had no javascript then the context would not have been created and as a result this method will not be called.
|
/// Called for every V8Context. To determine if V8Context is from Main frame check <see cref="IFrame.IsMain"/>
|
/// </summary>
|
/// <param name="chromiumWebBrowser">The ChromiumWebBrowser control</param>
|
/// <param name="browser">The browser object</param>
|
/// <param name="frame">The frame.</param>
|
void OnContextReleased(IWebBrowser chromiumWebBrowser, IBrowser browser, IFrame frame);
|
|
/// <summary>
|
/// Invoked when an element in the UI gains focus (or possibly no
|
/// element gains focus; i.e. an element lost focus).
|
/// </summary>
|
/// <param name="chromiumWebBrowser">The ChromiumWebBrowser control</param>
|
/// <param name="browser">The browser object</param>
|
/// <param name="frame">The frame object</param>
|
/// <param name="node">An object with information about the node (if any) that has focus.</param>
|
void OnFocusedNodeChanged(IWebBrowser chromiumWebBrowser, IBrowser browser, IFrame frame, IDomNode node);
|
|
/// <summary>
|
/// OnUncaughtException is called for global uncaught exceptions in a frame. Execution of this callback is disabled by default.
|
/// To enable set CefSettings.UncaughtExceptionStackSize > 0.
|
/// </summary>
|
/// <param name="chromiumWebBrowser">The ChromiumWebBrowser control</param>
|
/// <param name="browser">The browser object</param>
|
/// <param name="frame">The frame</param>
|
/// <param name="exception">The exception object with the message and stacktrace.</param>
|
void OnUncaughtException(IWebBrowser chromiumWebBrowser, IBrowser browser, IFrame frame, JavascriptException exception);
|
}
|
}
|