CEF3 常用类的介绍

最新推荐文章于 2020-10-18 23:04:29 发布

冷月醉雪

最新推荐文章于 2020-10-18 23:04:29 发布

阅读量1.5k

点赞数 1

分类专栏： CEF 文章标签： CEF3 类介绍

本文链接：https://blog.csdn.net/lengyuezuixue/article/details/79097412

版权

CEF 专栏收录该内容

6 篇文章 0 订阅

订阅专栏

CEF3作为一个基于Chromium的嵌入式浏览器框架为开发者提供了几个基本的接口类来完成一些基本功能。

CefApp类介绍

CefApp：与进程，命令行参数，代理，资源管理相关的回调类，用于让CEF3的调用者们定制自己的逻辑。与该类相关的几个函数如下：

int CefExecuteProcess(const CefMainArgs& args, CefRefPtr<CefApp> application);                                  bool CefInitialize(const CefMainArgs& args, const CefSettings& settings,  CefRefPtr<CefApp> application);

CefExecuteProcess()和CefInitialize()都可以将CefApp类的一个对象作为参数传递进来。

另外，CefApp的主要接口如下，其中OnBeforeCommandLineProcessing函数在你的程序启动CEF和Chromium之前给你提供了修改命令行参数的机会；

OnRegisterCustomSchemes用于注册自定义schemes，剩下的接口用于返回相关回调函数的Handler。

// Provides an opportunity to view and/or modify command-line arguments before   
// processing by CEF and Chromium. The |process_type| value will be empty for   
// the browser process. Do not keep a reference to the CefCommandLine object   
// passed to this method. The CefSettings.command_line_args_disabled value   
// can be used to start with an empty command-line object. Any values 
// specified in CefSettings that equate to command-line arguments will be set   
// before this method is called. Be cautious when using this method to modify   
// command-line arguments for non-browser processes as this may result in   
// undefined behavior including crashes. 
virtual void OnBeforeCommandLineProcessing(       
      const CefString& process_type, 
   CefRefPtr<CefCommandLine> command_line) {
}
  
// Provides an opportunity to register custom schemes. Do not keep a reference   
// to the |registrar| object. This method is called on the main thread for   
// each process and the registered schemes should be the same across all  
// processes. 
virtual void OnRegisterCustomSchemes( 
    CefRefPtr<CefSchemeRegistrar> registrar) {   
} 
 
// Return the handler for resource bundle events. If 
// CefSettings.pack_loading_disabled is true a handler must be returned. If no  
// handler is returned resources will be loaded from pack files. This method  
// is called by the browser and render processes on multiple threads. 
virtual CefRefPtr<CefResourceBundleHandler> GetResourceBundleHandler() { 
    return NULL;   
}  
  
// Return the handler for functionality specific to the browser process. This   
// method is called on multiple threads in the browser process. 
virtual CefRefPtr<CefBrowserProcessHandler> GetBrowserProcessHandler() {     
	return NULL;  
}  

// Return the handler for functionality specific to the render process. This   
// method is called on the render process main thread. 
virtual CefRefPtr<CefRenderProcessHandler> GetRenderProcessHandler() {     
	return NULL;  
}

CefClient 类介绍

CefClient：回调管理类，该类的对象作为参数可以被传递给CefCreateBrowser()或者CefCreateBrowserSync()函数。该类的主要接口如下：

// Return the handler for context menus. If no handler is provided the default   
// implementation will be used.    
virtual CefRefPtr<CefContextMenuHandler> GetContextMenuHandler() {
	return NULL;
}

// Return the handler for dialogs. If no handler is provided the default   
// implementation will be used. 
virtual CefRefPtr<CefDialogHandler> GetDialogHandler() {
     return NULL;   
}  

// Return the handler for browser display state events. 
virtual CefRefPtr<CefDisplayHandler> GetDisplayHandler() {
     return NULL;   
}  
  
// Return the handler for download events. If no handler is returned downloads   
// will not be allowed. 
virtual CefRefPtr<CefDownloadHandler> GetDownloadHandler() {
     return NULL;   
}  

// Return the handler for focus events. 
virtual CefRefPtr<CefFocusHandler> GetFocusHandler() {
     return NULL;   
}

// Return the handler for geolocation permissions requests. If no handler is   
// provided geolocation access will be denied by default.    
virtual CefRefPtr<CefGeolocationHandler> GetGeolocationHandler() {
     return NULL;   
}     

// Return the handler for JavaScript dialogs. If no handler is provided the   
// default implementation will be used.    
virtual CefRefPtr<CefJSDialogHandler> GetJSDialogHandler() {
     return NULL;   
}     

// Return the handler for keyboard events.    
virtual CefRefPtr<CefKeyboardHandler> GetKeyboardHandler() {
     return NULL; 
}

// Return the handler for browser life span events.    
virtual CefRefPtr<CefLifeSpanHandler> GetLifeSpanHandler() {
     return NULL;   
}     

// Return the handler for browser load status events.   
virtual CefRefPtr<CefLoadHandler> GetLoadHandler() {
     return NULL;   
}     

// Return the handler for off-screen rendering events.    
virtual CefRefPtr<CefRenderHandler> GetRenderHandler() {
     return NULL;   
}     

// Return the handler for browser request events.    
virtual CefRefPtr<CefRequestHandler> GetRequestHandler() {
     return NULL;  
}

// Called when a new message is received from a different process. Return true   
// if the message was handled or false otherwise. Do not keep a reference to   
// or attempt to access the message outside of this callback.    
virtual bool OnProcessMessageReceived(CefRefPtr<CefBrowser> browser,
                                      CefProcessId source_process,
				      CefRefPtr<CefProcessMessage> message) {     
		return false; 
}

CefClient 中返回的回调类包括：