(原创) 基于Chromium构建Chrome WebBrowser for .net 控件(还有点心得体会)
首先向360说句sorry,在2011年360极速浏览器出现的时候我去他们论坛里骂过。为什么要到歉呢,因为2012年我把我们公司使用IE WebBrowser改为Chrome控件了,中间遇到的辛酸使我明白360公司能做成产品确实不容易。言归正转,公司的壳程序是C#编写的WinForm程序,刚开始我只找到delphi的Chromium项目,然后在delphi2010中安装好控件后就生成DLL让WinForm程序调用,这种策略是我做这个控件的最大失败。因为我对delphi比较熟,很快控件就能在WinForm程序里跑起来了,很开心,立马根据壳中已经使用的事件和方法在自定义控件中实现,自测一下没有问题后就交给测试人员来试用,半天的功夫,测试员小张就来对我说:罗兄,网页中不能使用键盘上Tab键切换,回车事件响应不了......不会吧,是不是焦点没有定位到自定义控件中,我第一时间就是这样想,然后就是反复的折腾,还是不行。最后Google了一下,好不容易找到一个让自己信服的答案,就是win32的消息循环机制与.net消息机制不一样,嵌入到WinForm中的VCL控件不能得到消息。我靠,这还得了,leader还不把我劈了,leader已经吩咐美工全按chrome浏览器的样式来写了。兵来将挡,水来土淹,我火速Google一个能在.net上跑的版本“CefSharp” ,下载来看,傻眼了,是C++版的,咋办?熬夜啃吧!
我分为了两个项目,一是libfuncs,为了使DLL名称一致,我重命名了CefSharp项目,它负责提供操作浏览器的方法和触发事件;二是cwber,它是自定义的WinForm控件,用于在Form上的布局,必须引用libfuncs.dll。
源码地址:https://sourceforge.net/projects/chromewebbrowse
cwber比较简单,以下是它的代码:
using System;using System.Collections.Generic;using System.ComponentModel;using System.Drawing;using System.Data;using System.Text;using System.Windows.Forms;using libfuncs;namespace cwber{ public partial class ChromeWebBrowser : UserControl { private ChromeApp chrome = null; ToolTip myToolTip = new ToolTip(); public ChromeWebBrowser() { InitializeComponent(); ChromeWebBrowser.CheckForIllegalCrossThreadCalls = false; } private void ChromeWebBrowser_Load(object sender, EventArgs e) { if (chrome == null) { chrome = new ChromeApp(); } Start(); } #region 外部调用方法 libfuncs.DocumentCompletedEvent elementEvent1; libfuncs.FrameLoadStartEvent elementEvent2; libfuncs.FrameLoadEndEvent elementEvent3; libfuncs.FileDownloadingEvent fileDownloading; libfuncs.FileDownloadCompletedEvent fileDownloaded; libfuncs.ComponentInitialized componentInitialized; libfuncs.ToolTipEventListener toolTipEvent; public void Start() { if (chrome != null) { chrome.Dock = DockStyle.Fill; if (componentInitialized == null) { componentInitialized = new libfuncs.ComponentInitialized(componentInitializedEvent); chrome.RegisterEvent(componentInitialized); } Controls.Add(chrome); if (elementEvent1 == null) { elementEvent1 = new libfuncs.DocumentCompletedEvent(documentComplete); chrome.RegisterEvent(elementEvent1); } if (elementEvent2 == null) { elementEvent2 = new libfuncs.FrameLoadStartEvent(frameStartStart); chrome.RegisterEvent(elementEvent2); } if (elementEvent3 == null) { elementEvent3 = new libfuncs.FrameLoadEndEvent(frameLoadEnd); chrome.RegisterEvent(elementEvent3); } if (fileDownloading == null) { fileDownloading = new libfuncs.FileDownloadingEvent(this.downloading); chrome.RegisterEvent(fileDownloading); } if (fileDownloaded == null) { fileDownloaded = new libfuncs.FileDownloadCompletedEvent(this.downloaded); chrome.RegisterEvent(fileDownloaded); } if (toolTipEvent == null) { toolTipEvent = new libfuncs.ToolTipEventListener(this.ShowToolTipText); chrome.RegisterEvent(toolTipEvent); } chrome.Visible = true; chrome.BringToFront(); } } /* * 描述:释放浏览器 */ public void Free() { elementEvent1 = null; elementEvent2 = null; elementEvent3 = null; fileDownloading = null; fileDownloaded = null; componentInitialized = null; toolTipEvent = null; chrome.Dispose(); chrome = null; } /* * 参数:Url 打开网页地址 * 描述:打开网址。 */ public void OpenUrl(string Url) { if (chrome != null) chrome.Load(Url); } /* * 参数:id 网页中的控件元素ID * 描述:根据元素ID获取元素的值,适用于Input,A标签元素 */ public string GetElementValueById(string id) { return chrome == null ? "" : chrome.GetElementValueById(id); } /* * 参数:id 网页中的控件元素ID, value 元素新值 * 描述:为页面中元素赋予新值。 */ public void SetElementValueById(string id, string value) { if (chrome != null) { chrome.SetElementValueById(id, value); } } public delegate void TCallBackElementEventListener(); private List<libfuncs.ElementEventListener> elementEventList = new List<libfuncs.ElementEventListener>(); /* * 描述:附加元素的侦听事件。当该元素触发附加事件时,则执行TCallBackElementEventListener委托方法 */ public void AppendElementEventListener(string id, string eventName, TCallBackElementEventListener callFunc) { libfuncs.ElementEventListener elementEvent = new libfuncs.ElementEventListener(callFunc); elementEventList.Add(elementEvent); chrome.AddElementEventListener(id, eventName, elementEvent); } /* * 描述:向页面中注入并执行脚本。 */ public void ExecuteScript(string script) { if (chrome != null) chrome.ExecuteScript(script); } public object EvaluateScript(string script) { if (chrome != null) return chrome.EvaluateScript(script); else return null; } /* * 描述:计算文件单位。用于文件下载。 */ private string CompareFileSize(Int64 size) { //计算K,M单位 string strTotalSize = string.Empty; if (size < 1024) { strTotalSize = size.ToString() + " B"; } else if (size >= 1024 && size < 1024 * 1024) { strTotalSize = (size / 1024).ToString() + " KB"; } else { strTotalSize = (size / 1024 / 1024).ToString() + " MB"; } return strTotalSize; } #endregion #region 属性 public string Url { get { return chrome == null?"":chrome.Core.Address; } } #endregion #region 事件 /*控件初始化事件*/ public event EventHandler ComponentInitializedEventHandler; private void componentInitializedEvent() { EventArgs e = new EventArgs(); if (ComponentInitializedEventHandler != null) ComponentInitializedEventHandler(this, e); } /*页面加载完成事件*/ public event EventHandler DocumentCompletedEventHandler; private void documentComplete() { EventArgs e = new EventArgs(); if (DocumentCompletedEventHandler != null) DocumentCompletedEventHandler(this, e); } /*Frame加载完成事件,这里的Frame可以是页面本身,也是iFrame元素*/ public event EventHandler PageLoadFinishEventHandler; private void frameLoadEnd() { EventArgs e = new EventArgs(); if (PageLoadFinishEventHandler != null) PageLoadFinishEventHandler(this, e); } /*Frame加载开始事件,这里的Frame可以是页面本身,也是iFrame元素*/ public event EventHandler PageLoadStartEventHandler; private void frameStartStart() { EventArgs e = new EventArgs(); if (PageLoadStartEventHandler != null) PageLoadStartEventHandler(this, e); } /*下载中事件,不开放该事件*/ Form downloadForm = null; private void downloading(Int64 totalSize, Int64 loadedSize) { string strTotalSize = CompareFileSize(totalSize); string strLoadedSize = CompareFileSize(loadedSize); if (downloadForm == null) { downloadForm = new Form(); downloadForm.Text = "下载中"; downloadForm.Width = 280; downloadForm.Height = 150; downloadForm.MaximizeBox = false; downloadForm.MinimizeBox = false; downloadForm.ControlBox = false; downloadForm.StartPosition = FormStartPosition.CenterScreen; Label label = new Label(); label.Left = 20; label.Top = 50; label.Width = 250; label.Text = "已下载:" + strLoadedSize + "/" + strTotalSize; downloadForm.Controls.Add(label); } downloadForm.Show(); downloadForm.BringToFront(); foreach (Control c in downloadForm.Controls) { if (c is Label) { Label label = (Label)c; label.Text = "已下载:" + strLoadedSize + "/" + strTotalSize; label.Update(); } } downloadForm.Update(); } /*下载完成事件,不开放该事件*/ private void downloaded() { if (downloadForm != null) downloadForm.Close(); downloadForm = null; } /*消息提示事件,不开放*/ private void ShowToolTipText(string text) { if (chrome == null) return; if (string.IsNullOrEmpty(text)) { myToolTip.RemoveAll(); return; } //保证每行40个字 int len = text.Length; int offset = 40; int count = len / offset; for (int i = 1; i <= count; i++) { text = text.Insert(offset * i, "\n"); } myToolTip.ShowAlways = false; myToolTip.UseAnimation = true; myToolTip.UseFading = true; //t.SetToolTip(button1, text); Point p = Control.MousePosition; Point p1 = this.PointToClient(p); myToolTip.Show(text, chrome, p1.X+20, p1.Y+10); } #endregion }}
最后说句,我们公司网页美工解脱了!