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

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

一:

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

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

希望虚心学习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

郑重声明:本站内容如果来自互联网及其他传播媒体,其版权均属原媒体及文章作者所有。转载目的在于传递更多信息及用于网络分享,并不代表本站赞同其观点和对其真实性负责,也不构成任何其他建议。