CEF3开发者系列之类和接口

时间:2022-07-19 06:25:25

CEF3基本的框架包含C/C++程 序接口,通过本地库的接口来实现,而这个库则会隔离宿主程序和 Chromium&Webkit的操作细节。它在浏览器控件和宿主程序之间提供紧密的整合,它支持用户插件,协议,javascript对象以及 javascript扩展,宿主程序可以随意地控件资源下载,导航,下下文内容和打印等。下边总结一些最常用到的类和接口,便于了解整个cef3的代码。

CefBrowser是主要的浏览器窗口类,可以用静态的函数CreateBrowser() 和CreateBrowserSync() 来创建一个新的浏览器窗口,公开由浏览器提供的功能。包括前进后退导航,来源检索,加载请求等。

CefFrame 代表一个浏览器窗口的框架,每个浏览器窗口有一个顶层的主框架,而这个主框架可以用GetMainFrame() 方法得到。

CefBrowser和CefFrame对象被用来发送命令给浏览器以及在回调函数里获取状态信息。每个CefBrowser对象包含一个主 CefFrame对象,主CefFrame对象代表页面的顶层frame;同时每个CefBrowser对象可以包含零个或多个的CefFrame对象, 分别代表不同的子Frame。例如,一个浏览器加载了两个iframe,则该CefBrowser对象拥有三个CefFrame对象(顶层frame和两 个iframe)。

CefApp,此接口用来传递到CefInitialize(),和允许应用程序定制全局,如资源加载,代理。一些功能是由所有进程共享的,有些必须实现浏览器的过程中,必须在渲染过程中执行。见详情头文件的注释。

CefClient:是主浏览器窗口的代表接口,这个接口做为参数传递给CreateBrowser()

CefRequest:代表URL,方法,发送数据和头文件等这样的请求。

CefSchemeHandleFactory:被用来处理像myscheme://mydomain类似客户计划的请求

CefReadHandler和CefWriteHandle是一个读写数据的简单接口。

CefV8Handler,CefV8Value和CefV8Context是被用来创建和访问JavaScript对象。

CefBrowserHost:有关运行browser进程中唯一可用的browser窗口的功能。例如,检索本地父窗口句柄,或销毁browser窗口。

CefRenderProcessHandler:WebKit和V8对渲染进程中应用程序的集成能力。通过CefApp返回此对象的一个​​实例。

CefCookie:处理cookie的功能。

使用CEF3开发的过程中,CefClient使用最频繁的,了解cefclient中的回调类是很有必要的。所谓回调类,就是浏览器相关的动作发生时,去回调一些事件函数,用户可以在事件中获取或修改相关的信息。cefclient中的回调类包括:

CefContextMenuHandler,回调类,主要用于处理 Context Menu 事件。

CefDialogHandler,回调类,主要用来处理对话框事件。

CefDisplayHandler,回调类,处理与页面状态相关的事件,如页面加载情况的变化,地址栏变化,标题变化等事件。

GetDragHandler,回调类,处理拖拽相关的事件,如从外边拖入浏览器事件

CefDownloadHandler,回调类,主要用来处理文件下载。

CefFocusHandler,回调类,主要用来处理焦点事件。

CefGeolocationHandler,回调类,用于申请 geolocation 权限。

CefJSDialogHandler,回调类,主要用来处理 JS 对话框事件。

CefKeyboardHandler,回调类,主要用来处理键盘输入事件。

CefLifeSpanHandler,回调类,主要用来处理与浏览器生命周期相关的事件,与浏览器对象的创建、销毁以及弹出框的管理。

CefLoadHandler,回调类,主要用来处理浏览器页面加载状态的变化,如页面加载开始,完成,出错等。

CefRenderHandler,回调类,主要用来处在在窗口渲染功能被关闭的情况下的事件。

CefRequestHandler,回调类,主要用来处理与浏览器请求相关的的事件,如资源的的加载,重定向等。

CEF3的CefBrowser类是实现浏览器最主要的一个类。主要有以下实现类组成:

CefMainDelegate实现通用进程的引导逻辑。

CefContentClient实现所有进程*同的ContentAPI回调。

CefContext代表全局CEF内容在browser进程中。单个CefContext对象由CefInitialize()创建并由CefShutdown()销毁。

CefBrowserMainParts实现browser进程中的引导逻辑。

CefContentBrowserClient实现browser进程的ContentAPI回调。

CefBrowserHostImpl实现在browser进程中CefBrowser和CefBrowserHost的接口。提供粘合代码和工具的接口来和RenderViewHost通信。

CefContentRendererClient实现渲染进程中的ContentAPI回调。

CefBrowserImpl实现渲染进程中的CefBrowser接口。提供粘合代码和工具的借口来和RenderView通信。