基于.net开发chrome核心浏览器【四】

本文转载自： https://www.cnblogs.com/liulun/archive/2013/05/31/3079516.html 作者：liulun 转载请注明该声明。

一：

上周去北京出差，给国家电网的项目做架构方案，每天都很晚睡，客户那边的副总也这样拼命工作。

累的不行了，直接导致第四篇文章没有按时发出来。

希望虚心学习1，小侠客等关注我的朋友们原谅我。

二：

在这篇文章中，我们主要实现下面三个功能：

浏览器地址栏、浏览器窗口大小变化、浏览器下载文件

为了实现这三个功能，我们新创建了一个工程，

program.cs文件里的内容没有任何变动；

dll文件夹里的内容没有任何变动；

资源的引用，程序集的配置，都没有做任何变动；

三：

我们在解决方案中创建一个bs文件夹，这个文件夹中放置与浏览器相关的类。

首先在这个文件夹中创建一个叫BsDownloadHandler的类

顾名思义，这个类是为下载文件而创建的。

如果想实现下载文件，首先要让这个类继承CefDownloadHandler

然后重写父类的OnBeforeDownload和OnDownloadUpdated两个方法

重写的代码如下：

        protected override void OnBeforeDownload(CefBrowser browser, CefDownloadItem downloadItem, string suggestedName, CefBeforeDownloadCallback callback)
        {
            callback.Continue(string.Empty, true);
        }
protected override void OnDownloadUpdated(CefBrowser browser, CefDownloadItem downloadItem, CefDownloadItemCallback callback)
        {
if (downloadItem.IsComplete)
            {
                MessageBox.Show("下载成功");
if (browser.IsPopup && !browser.HasDocument)
                {
                    browser.GetHost().ParentWindowWillClose();
                    browser.GetHost().CloseBrowser();
                }
            }
        }

OnBeforeDownload方法，在浏览器开始下载文件之前被调用，CEF在默认情况下屏蔽了所有文件下载的事件

如果希望CEF处理下载事件，那么就要调用callback参数的Continue事件。

suggested_name参数是下载文件的建议名称，也就是保存文件对话框出来之后，文件名称文本框里的内容。

--------------------------

OnDownloadUpdated方法，CEF在下载文件过程中会多次调用此方法，并不是只有完成下载了之后再调用这个方法。

如果你想终止下载，也可以调用callback参数的Cancel方法

--------------------------

downloadItem是描述下载文件的类型的实例，

他里面有一系列的属性，

包括：是否完成、是否取消、当前速度、完成的百分比、完成了多少比特、一共有多少比特、开始时间、结束时间等等

不要试图在上面两个方法之外，引用这个实例。

----------------------------

因为浏览器下载文件有很多方式，有可能是通过window.open(js)的方式打开一个路径来下载文件

这时，我们要关掉被打开的窗口，(CEF不会自动帮我们关掉这类窗口)所以在获知下载完成之后，又执行了如下两句代码：

                if (browser.IsPopup && !browser.HasDocument)
                {
                    browser.GetHost().ParentWindowWillClose();
                    browser.GetHost().CloseBrowser();
                }

四：

为了能使浏览器的窗口大小，随着容器的窗口大小变化而变化。

我们必须要知道，浏览器的窗口句柄何时创建成功，何时被加入到父窗口中去了。

在上一篇文章中，我们提到CefBrowserHost.CreateBrowser方法是异步的。

我们要想一些办法，来获取这个方法执行成功后，所创建的浏览器窗口的句柄。

首先，我们要在bs文件夹内创建一个名为BsLifeSpanHandler的类

这个类继承自CefLifeSpanHandler，我们在这个类中重写了OnAfterCreated方法

整个类的代码如下：

    public class BsLifeSpanHandler : CefLifeSpanHandler
    {
private BsClient bClient;
public BsLifeSpanHandler(BsClient bc)
        {
            bClient = bc;
        }
protected override void OnAfterCreated(Xilium.CefGlue.CefBrowser browser)
        {
base.OnAfterCreated(browser);
            bClient.Created(browser);
        }
    }

创建这个类的实例，必须传入一个BsClient的实例，关于BsClient的内容，我们稍后再讲

基类CefLifeSpanHandler中有很多方法可供重载。

包括：弹窗之前的事件、浏览器窗口创建成功后的事件、执行模态窗的事件、关闭窗口之前的事件

（虽然这里叫事件，但其实是方法，只不过CEF会自动调用这些方法）

我们在这个类中重写了OnAfterCreated方法（浏览器窗口创建成功后的事件），

在这个方法中，我们调用了BsClient实例的Created方法，

并且把browser实例当作参数传递给了这个方法

这里的browser其实就是我们创建出来的浏览器核心，可以通过它获取浏览器的窗口句柄。

五： 

我们在上一篇文章中，创建了一个BrowserClient类，这个类继承自CefClient。

但我们并没有给这个类任何实现，只是在调用CefBrowserHost.CreateBrowser方法时，传递了这个类的一个实例

现在，我们把这个类放到bs文件夹中去，并改名为BsClient，为这个类增加如下实现代码：

    public class BsClient:CefClient
    {
public event EventHandler OnCreated;
private readonly CefLifeSpanHandler lifeSpanHandler;
private readonly CefDownloadHandler downloadHandler;        
public BsClient()
        {
            lifeSpanHandler = new BsLifeSpanHandler(this);
            downloadHandler = new BsDownloadHandler();
        }
protected override CefLifeSpanHandler GetLifeSpanHandler()
        {
return lifeSpanHandler;
        }
protected override CefDownloadHandler GetDownloadHandler()
        {
return downloadHandler;
        }
public void Created(CefBrowser bs)
        {
if (OnCreated != null)
            {
                OnCreated(bs, EventArgs.Empty);
            }
        }
    }

在这个类中，我们重写了GetLifeSpanHandler和GetDownloadHandler方法，

这样，我们前面创建的BsLifeSpanHandler和BsDownloadHandler才会物尽其用。

还可以在这里重写很多方法，

比如：GetContextMenuHandler（右键菜单句柄），GetDialogHandler（对话框句柄）GetKeyboardHandler（键盘句柄）等

在这个类中我们还公开了一个OnCreated的事件，Created方法会调用这个事件。

而这个方法，是在BsLifeSpanHandler类中被调用的。

也就是说，当浏览器创建完成时，OnCreated事件会被触发。

六：

我们在bs文件夹下创建一个类BsCtl

这个类就是我们的浏览器控件，

先来看一下这个类唯一的构造函数：

        public BsCtl(Control ctl)
        {
            parent = ctl;
var cwi = CefWindowInfo.Create();
            cwi.SetAsChild(parent.Handle, new CefRectangle(0, 0, parent.Width, parent.Height));
var bc = new BsClient();
            bc.OnCreated += bc_OnCreated;
var bs = new CefBrowserSettings() { };
            CefBrowserHost.CreateBrowser(cwi, bc, bs, "http://www.cnblogs.com/liulun");
            parent.SizeChanged += parent_SizeChanged;
        }

你会发现，上一篇文章中的几行核心代码，都搬到这里来了。

构造函数的参数ctl，是一个windows控件，一般是个panel之类的容器控件，

我们创建的浏览器窗口就将呈现在这个容器控件内

同时，我们为这个容器控件注册了SizeChanged事件

也为BsClient注册了OnCreated事件。

我们在创建默认浏览器的时候，指定了它的默认主页（就是我的博客）

你如果不想这么办，你可以指定它为：about:blank

----------------------------

下面我们看一下这两个事件的实现代码

void bc_OnCreated(object sender, EventArgs e)
        {
            bs = (CefBrowser)sender;
var handle = bs.GetHost().GetWindowHandle();
            ResizeWindow(handle,parent.Width,parent.Height);
        }

void parent_SizeChanged(object sender, EventArgs e)
        {
if (bs != null)
            {
var handle = bs.GetHost().GetWindowHandle();
                ResizeWindow(handle, parent.Width, parent.Height);                
            }
        }

在浏览器创建成功的事件中，我们把浏览器的实例保存成了私有属性

他是一个核心对象，以后有很多地方会用到。

我们通过bs.GetHost().GetWindowHandle();来获得浏览器窗口的句柄。

有了这个句柄，我们就可以重置浏览器窗口的大小，使他随着主窗体的大小变化而变化

--------------------------------

下面来看一下ResizeWindow方法的代码：

        [DllImport("user32.dll")]
        [return: MarshalAs(UnmanagedType.Bool)]
public static extern bool SetWindowPos(IntPtr hWnd, IntPtr hWndInsertAfter, int X, int Y, int cx, int cy, uint uFlags);

private void ResizeWindow(IntPtr handle, int width, int height)
        {
if (handle != IntPtr.Zero)
            {
                NativeMethod.SetWindowPos(handle, IntPtr.Zero,
0, 0, width, height,
0x0002 | 0x0004
                    );
            }
        }

在ResizeWindow方法中，通过PInvoke方式调用了windows api的方法，来设置浏览器窗口的位置和大小

其中0x0002相当于SWP_NOMOVE；0x0004相当于SWP_NOZORDER

---------------------------

在这个类中，还有一个方法，代码如下：

        public void LoadUrl(string url)
        {
            bs.GetMainFrame().LoadUrl(url);
        }

这个方法负责切换浏览器的地址

七：

现在我们来设计主窗口

一些必要的布局代码如下，就不多做解释了：

            this.AddressContainer.Anchor = ((System.Windows.Forms.AnchorStyles)(((System.Windows.Forms.AnchorStyles.Top | System.Windows.Forms.AnchorStyles.Left) 

this.GoBtn.Anchor = ((System.Windows.Forms.AnchorStyles)((System.Windows.Forms.AnchorStyles.Top | System.Windows.Forms.AnchorStyles.Right)));

this.AddressTB.Anchor = ((System.Windows.Forms.AnchorStyles)(((System.Windows.Forms.AnchorStyles.Top | System.Windows.Forms.AnchorStyles.Left) 

this.BrowserContainer.Anchor = ((System.Windows.Forms.AnchorStyles)((((System.Windows.Forms.AnchorStyles.Top | System.Windows.Forms.AnchorStyles.Bottom) 

this.StatusContainer.Anchor = ((System.Windows.Forms.AnchorStyles)(((System.Windows.Forms.AnchorStyles.Bottom | System.Windows.Forms.AnchorStyles.Left) 

------------------------------------------

经过前面的一系列工作，我们主窗口的代码就精简了很多

    public partial class Demo : Form
    {
        BsCtl bs;
public Demo()
        {
            InitializeComponent();
this.Name = "CefBrowser";
this.Text = "最简单的实现";            
        }
private void CefBrowser_Load(object sender, EventArgs e)
        {
            bs = new BsCtl(BrowserContainer);
        }

private void GoBtn_Click(object sender, EventArgs e)
        {
if (!string.IsNullOrWhiteSpace(AddressTB.Text))
            {
                bs.LoadUrl(AddressTB.Text);
            }
        }
    }

在窗口加载成功后，我们创建了浏览器的实例（创建时把浏览器容器传递给了构造函数），

当点击GO按钮的时候，切换了浏览器的地址。

-------------------------------------------------

最终的效果如下（浏览器窗口的大小会随着主窗口的大小而变化）

源码下载：

http://files.cnblogs.com/liulun/CefDemo2.zip