CEF完整嵌入DUI窗体(三) --基本浏览器功能

Cef将浏览器的功能非常清晰的做了封装，该抛出的接口抛出，该回调的接口回调，学习谷歌的代码，愈发的会感觉到这种清晰简洁的优美；现在我们按照功能区分来讲解代码；这一节我们首先介绍浏览器的简单功能，包括创建，导航，关闭等

一，创建浏览器

这里我们直接自己封装了一个浏览器创建接口，实现了一些回调接口solt的设置等

void CBrowserClient::CreateCefWindow(HWND hWnd, const CefString& url,
ILifeSpanHandleSlot* life_handle,
ILoadHandleSlot* load_handle,
IDisplayHandleSolt* display_handle,
ILifeSpanFileDialogSolt* filedialog_handle) {
//这里Cef要求创建浏览器的接口只能在UI主线程中调用，其他地方调用可能会使程序奔溃
if (!CefCurrentlyOn(TID_UI)) {
// Execute this method on the UI thread.
CefPostTask(TID_UI, base::Bind(&CBrowserClient::CreateCefWindow, this,
hWnd, url, life_handle, load_handle,
display_handle, filedialog_handle));
return;
}

CEF_REQUIRE_UI_THREAD();
CefWindowInfo info;

//创建子窗口
RECT rect = { 0, 0, 1, 1 };
//设置浏览器窗体为Dui的内嵌窗体
info.SetAsChild(hWnd, rect);
//这里设置了我们需要的向上层抛出的回调接口，之后会讲解
life_handle_->SetSolt(life_handle);
load_handle_->SetSolt(load_handle);
display_handle_->SetSolt(display_handle);
filedialog_handle_->SetSolt(filedialog_handle);
//创建浏览器
CefBrowserSettings b_settings;
CefBrowserHost::CreateBrowserSync(info, this, url, b_settings, NULL);
}

二，导航，回退，重新加载，执行JS代码，关闭浏览器等普通操作

定义一个叫做 CBrowserClient 的类，继承CefClient 类（这个类是Cef回调管理类，其中定了很多接口集的指针向Cef内部返回，我们需要哪个接口就让CBrowserClient 同时继承这个接口集的类，然后多态实现CefClient的返回接口即可）这里我们需要用到的是CefLifeSpanHandler回调接口类，顾名思义，这个接口类会在Cef浏览器生命周期的各个关键点回调

class CBrowserClient :
public CefClient,       //回调管理类
public CefDisplayHandler//生命周期回调类

多态实现派生类指针返回

CefRefPtr<CefDisplayHandler> CBrowserClient::GetDisplayHandler() {
return this;
}

我们这里需要用到一个接口，在浏览器创建完成之后返回，参数中会携带创建完成的浏览器对象

void CBrowserClient::OnAfterCreated(CefRefPtr<CefBrowser> browser) {
CEF_REQUIRE_UI_THREAD();
base::AutoLock lock_scope(lock_);
//定义一个CefRefPtr<CefBrowser> browser_  来保存返回的浏览器对象
if (!browser_) {
browser_ = browser;
}
}

所有的浏览器操作都通过这个浏览器对象来主动调用：

//是否可以向前导航
browser_->CanGoForward();
//向前导航
browser_->GoForward();
//重新加载
browser_->Reload();
//忽略缓存加载
browser_->ReloadIgnoreCache();
//停止加载
browser_->StopLoad();
//是否可以向后导航
browser_->CanGoBack();
//向后导航
browser_->GoBack();
//获取浏览器窗体句柄
return browser_->GetHost()->GetWindowHandle();
//设置焦点
browser_->GetHost()->SetFocus(bool focus);
//获取缩放比例
browser_->GetHost()->GetZoomLevel();
//设置缩放比例
browser_->GetHost()->SetZoomLevel(int zoomLevel);
//加载url
browser_->GetMainFrame()->LoadURL(std::wstring url);
//获取当前Url
browser_->GetMainFrame()->GetURL();
//执行js代码
browser_->GetMainFrame()->ExecuteJavaScript(std::wstring jscode, "", 0);
//关闭浏览器 传参为true将不弹出alert直接关闭
browser_->GetHost()->CloseBrowser(bool /*true*/);
//设置浏览器焦点
browser_->GetHost()->SetFocus(bool enable);

三，实现右键菜单

右键菜单同样需要我们在Cef的回调接口中操作，CBrowserClient类再继承CefContextMenuHandler接口集类，多态实现派生类指针的返回：

CefRefPtr<CefContextMenuHandler> CBrowserClient::GetContextMenuHandler() {
return this;
}

在OnBeforeContextMenu回调接口中设置右键菜单项，在OnContextMenuCommand中实现右键菜单的相关操作，我们首先定义右键菜单的枚举类型

enum ContextMenuID {
RIGHT_MENU_REFRESH = 1001,//刷新
RIGHT_MENU_FORWARD,       //向前
RIGHT_MENU_BACKOFF,       //向后
};

接下来将这些项添加到右键菜单中

void CBrowserClient::OnBeforeContextMenu(CefRefPtr<CefBrowser> browser,
CefRefPtr<CefFrame> frame,
CefRefPtr<CefContextMenuParams> params,
CefRefPtr<CefMenuModel> model) {
if ((params->GetTypeFlags()&(CM_TYPEFLAG_PAGE | CM_TYPEFLAG_FRAME)) != 0) {
// Add a separator if the menu already has items.
if (model->GetCount() > 0) {
//清除默认项
model->Clear();
//model->AddSeparator();
}
//添加菜单项
model->AddItem(RIGHT_MENU_REFRESH, L"刷 新");
model->AddSeparator();
model->AddItem(RIGHT_MENU_FORWARD, L"前 进");
model->AddSeparator();
model->AddItem(RIGHT_MENU_BACKOFF, L"后 退");
}
}

实现右键菜单的具体操作

bool CBrowserClient::OnContextMenuCommand(CefRefPtr<CefBrowser> browser,
CefRefPtr<CefFrame> frame,
CefRefPtr<CefContextMenuParams> params,
int command_id,
EventFlags event_flags) {
switch (command_id) {
case RIGHT_MENU_REFRESH:
browser_->Reload();
return true;
case RIGHT_MENU_FORWARD:
if(browser_->CanGoForward()) {
browser_->GoForward();
}
return true;
case RIGHT_MENU_BACKOFF:
if(browser_->CanGoBack()) {
browser_->GoBack();
}
return true;
}
return false;
}

四，阻止客户端嵌入的浏览器被拖入本地文件

我们依然让CBrowserClient类来继承一个拖拽文件的接口集CefDragHandler，多态返回派生类的指针：

CefRefPtr<CefDragHandler> CBrowserClient::GetDragHandler() {
return this;
}

直接将拖拽触发的回调接口返回true即可

bool CBrowserClient::OnDragEnter(CefRefPtr<CefBrowser> browser,
CefRefPtr<CefDragData> dragData,
DragOperationsMask mask) {
return true;
}

五，屏蔽一些windows键盘操作

我想你已经知道了我要干嘛，依然让CBrowserClient类来继承一个键盘操作的接口集CefKeyboardHandler，多态返回派生类的指针：

CefRefPtr<CefKeyboardHandler> CBrowserClient::GetKeyboardHandler() {
return this;
}

屏蔽想要屏蔽的按键操作

bool CBrowserClient::OnPreKeyEvent(CefRefPtr<CefBrowser> browser,
const CefKeyEvent& event,
CefEventHandle os_event,
bool* is_keyboard_shortcut) {
if (os_event) {
//这里屏蔽掉alt+空格的操作
if (os_event->message == WM_SYSKEYDOWN || os_event->message == WM_SYSKEYUP) {
return true;
}
}
return false;
}

看到这里我想你已经发现Cef的一些特点，它把一些浏览器相关的事件封装成回调接口，供我们自己实现从而定制开发出嵌入客户端的浏览器，其他的一些诸如弹出文件选择对话框，显示控制台信息等操作都能通过CefClient管理的回调接口类中找到身影，继承之即可。如果觉得不过尔尔，那么接下来我们讲解下复杂一点的功能实现；