Cef对象介绍

chromium

CefSettings

可以通过CefSettings结构体来设置cef应用程序的特性。一些常用配置包括：

• single_process 为true时采用单进程模式。也可以使用命令行 “single-process”来设置。
• browser_subprocess_path 独立子进程可执行文件的路径。
• multi_threaded_message_loop 为true时，在一个独立的线程中运行cef消息循环。
• command_line_args_disabled 为true时，禁用命令行参数来配置浏览器的特性。
• cache_path 存储cache数据的磁盘路径。如果为空，某些功能的cache数据将保存在内存中，还有些其它的会临时保存在磁盘中。像HTML5数据库的localStorage必须指定cache路径才能跨session存储。
• locale 本地语言设置，字符串会传给Blink。如果为空，默认使用 “en-US”。Linux中会忽略此项，而是根据环境变量的值来确定，解析的顺序为：LANGUAGE, LC_ALL, LC_MESSAGES and LANG. 也可以通过命令行参数 “lang”设置。
• log_file debug日志的文件路径。如果为空，默认使用 “debug.log”，位于应用程序当前目录中。也可以通过命令行参数 “log-file”来设置。
• log_severity 日志级别。只有比当前级别高或相同的日志才会被记录。也可以通过命令行参数 “log-severity”来设置，预定义的值包括 “verbose”, “info”, “warning”, “error”, “error-report” 或者 “disable”。
• resources_dir_path 资源目录的全路径。如果为空， cef.pak和devtools_resources.pak文件必须放到模块同级目录中（Windows/Linux系统），或者app bundle Resources目录中（Mac OS X）。也可以通过命令行参数 “resources-dir-path”来设置。
• locales_dir_path locales目录的全路径。如果为空，locales目录必须和cef模块处于同级目录。Mac OS X 会忽略此项，它默认会从app bundle Resources目录加载。也可以通过命令行参数”locales-dir-path”来设置此项值。
• remote_debugging_port 在特定端口启用远程调试，值在1024~65535之间。比如，当此值设为8080时，远程调试url即为http://localhost:8080。你可以选择任意版本的cef及chrome浏览器来调试。也可以通过命令行参数 “remote-debugging-port”来设置此项值。

CefBrowser and CefFrame

CefBrowser和CefFrame对象用来发送命令给浏览器以及在回调函数里获取状态信息。每一个CefBrowser对象都有一个主CefFrame对象来代表最顶层的frame，有0个或者多个相关联的CefFrame对象来代表子frame。比如一个浏览器加载的网站中有两个iframe标签的，此时，一个CefBrowser对象会有三个CefFrame对象（一个顶层frame和两个子frame）。
利用浏览器的主frame加载一个URL:
browser->GetMainFrame()->LoadURL(some_url);
浏览器回退
browser->GoBack();
获取主frame的HTML内容

// Implementation of the CefStringVisitor interface.
class Visitor : public CefStringVisitor {
 public:
  Visitor() {}
  // Called asynchronously when the HTML contents are available.
  virtual void Visit(const CefString& string) OVERRIDE {
    // Do something with |string|...
  }
  IMPLEMENT_REFCOUNTING(Visitor);
};
browser->GetMainFrame()->GetSource(new Visitor());

CefBrowser和CefFrame对象存在于browser进程以及render进程中。浏览器的操作主要通过CefBrowser::GetHost()方法来掌控。比如，可以用如下方式获取浏览器窗口句柄：

// CefWindowHandle is defined as HWND on Windows, NSView* on Mac OS X
// and GtkWidget* on Linux.
CefWindowHandle window_handle = browser->GetHost()->GetWindowHandle();

其它一些方法可以实现历史导航、加载字符串、请求、发送编辑命令、获取文本内容，更多信息，请查看具体方法的完整文档。

CefApp

更多信息，可参考在线API文档