org.cef.handler

接口 CefLifeSpanHandler

所有已知实现类:

CefClient, CefLifeSpanHandlerAdapter

public interface CefLifeSpanHandler

Implement this interface to handle events related to browser life span. The methods of this class will be called on the UI thread unless otherwise indicated.

实现此接口以处理与浏览器生命周期相关的事件。除非另有说明，否则将在UI线程上调用此类的方法。

方法概要

限定符和类型	方法和说明
boolean	doClose(CefBrowser browser) Called when a browser has received a request to close. 在浏览器收到关闭请求时调用。
void	onAfterCreated(CefBrowser browser) Handle creation of a new browser window. 处理新浏览器窗口的创建。
void	onBeforeClose(CefBrowser browser) Called just before a browser is destroyed. 在浏览器被销毁之前调用。
boolean	onBeforePopup(CefBrowser browser, CefFrame frame, java.lang.String target_url, java.lang.String target_frame_name) Called on the IO thread before a new popup window is created. 在创建新的弹出窗口之前调用IO线程。

方法详细资料

doClose

boolean doClose(CefBrowser browser)

Called when a browser has received a request to close. If CEF created an OS window for the browser returning false will send an OS close notification to the browser window's top-level owner (e.g. WM_CLOSE on Windows, performClose: on OS-X and "delete_event" on Linux). If no OS window exists (window rendering disabled) returning false will cause the browser object to be destroyed immediately. Return true if the browser is parented to another window and that other window needs to receive close notification via some non-standard technique.

在浏览器收到关闭请求时调用。如果CEF为浏览器创建了一个OS窗口，返回false将向浏览器窗口的顶级所有者发送操作系统关闭通知（例如，Windows上的WM_CLOSE，OS-X上的performClose：和Linux上的“delete_event”）。如果不存在OS窗口（禁用窗口渲染），则返回false将导致浏览器对象立即被销毁。如果浏览器是另一个窗口的父级，并且其他窗口需要通过某种非标准技术接收关闭通知，则返回true。

参数:

browser - The browser generating the event. - 生成事件的浏览器。

返回:

false will send an OS close notification to the browser window's top-level owner. false会向浏览器窗口的顶级所有者发送操作系统关闭通知。

onAfterCreated

void onAfterCreated(CefBrowser browser)

Handle creation of a new browser window.

处理新浏览器窗口的创建。

参数:

browser - The browser generating the event. - 生成事件的浏览器。

onBeforeClose

void onBeforeClose(CefBrowser browser)

Called just before a browser is destroyed. Release all references to the browser object and do not attempt to execute any methods on the browser object after this callback returns. If this is a modal window and a custom modal loop implementation was provided in runModal() this callback should be used to exit the custom modal loop. See doClose() documentation for additional usage information.

在浏览器被销毁之前调用。释放对浏览器对象的所有引用，并且在此回调返回后不要尝试在浏览器对象上执行任何方法。如果这是一个模态窗口并且在runModal（）中提供了自定义模态循环实现，则应该使用此回调来退出自定义模态循环。有关其他用法信息，请参阅doClose（）文档。

参数:

browser - The browser generating the event. - 生成事件的浏览器。

onBeforePopup

boolean onBeforePopup(CefBrowser browser,
                      CefFrame frame,
                      java.lang.String target_url,
                      java.lang.String target_frame_name)

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.

(注意:此方法target_frame_name之后的参数已被注释，但是注释没有改，看到这些莫名其妙的参数可忽略，可查阅JCEF源码中的相关类)
在创建新的弹出窗口之前调用IO线程。 |browser|和| frame |参数表示弹出请求的来源。 | target_url |和| target_frame_name |如果没有为请求指定值，则值可能为空。 | popupFeatures | structure包含有关请求的弹出窗口的信息。要允许创建弹出窗口，可以选择修改| windowInfo |，| client |，| settings |和| no_javascript_access |并返回false。要取消创建弹出窗口，请返回true。 |客户|和|设置|值将默认为源浏览器的值。 | no_javascript_access | value表示新浏览器窗口是否应该是可编写脚本的，并且与源浏览器处于同一进程中。

参数:

browser - The source of the popup request. - 弹出请求的来源。

frame - The source of the popup request. - 弹出请求的来源。

target_url - May be empty if none is specified with the request. - 如果请求未指定，则可以为空。

target_frame_name - May be empty if none is specified with the request. - 如果请求未指定，则可以为空。

(注意:下面的参数不需要理会)

target_disposition - Indicates where the user intended to open the popup (e.g. current tab, new tab, etc). - 指示用户打算弹出窗口的位置（例如，当前选项卡，新选项卡等）。

user_gesture - 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). - 如果弹出窗口是通过显式用户手势（例如，单击链接）打开，则为true;如果弹出窗口自动打开（例如，通过DomContentLoaded事件），则为false。

popupFeatures - Contains information about the requested popup window - 包含有关请求的弹出窗口的信息

windowInfo - Can be modified. - 可以修改。

client - Can be modified. - 可以修改。

settings - Can be modified. - 可以修改。

no_javascript_access - Can be modified. - 可以修改。

返回:

To cancel creation of the popup window return true. 要取消创建弹出窗口，请返回true。