背景

Echarts 是百度推出的一个使用 JavaScript 实现的开源可视化库。 该库提供了常规的折线图、柱状图、散点图、饼图、K线图，用于统计的盒形图，用于地理数据可视化的地图、热力图、线图，用于关系数据可视化的关系图、treemap、旭日图，多维数据可视化的平行坐标，还有用于 BI 的漏斗图，仪表盘，并且支持图与图之间的混搭。

柱状图

散点图

关系图

三维图

既然 Echarts 提供了丰富的图形，所以咱们有必要把它封装起来，以便让其支持 Windows 窗体应用程序。

整体的技术方案就是做一个自定义控件，该控件中包含 WebBrowser 浏览器控件，通过该浏览器控件显示指定位置的网页。就像咱们直接通过 Web 浏览器网页一样。具体的步骤如下：

首先，创建一个在 Windows 窗体应用程序中使用的控件项目 LSGO.Core.ECharts。

其次，在该控件项目的设计器中，拖入一个 WebBrowser 控件，并设置其 Dock 属性为 Fill，即让 WebBrowser 充满整个容器。

接着，写一个 InitialECharts 方法，加载指定目录的网页.\assets\echarts.html，让该网页在 WebBrowser 中打开。

当该网页加载完成后，触发 WebBrowser 的 WebBrowserDocumentCompletedEventHandler 事件，在该事件注册的方法中调用该网页中用 JS 写的 showChart 方法，则在该网页中显示图形。

当窗体控件的尺寸发生变化后，触发 WebBrowser 的 SizeChanged 事件，在该事件注册的方法中调用该网页中用 JS 写的 setPosition 方法，则重新调整显示图形的布局，以满足新的尺寸。

WebBrowser 类的常用属性、事件与方法。

属性

///

/// 获取或设置一个对象，该对象可由显示在 WebBrowser 控件中的网页所包含的脚本代码访问。 ///

/// /// 可用于脚本代码的对象。 ///
public object ObjectForScripting { get; set; }

/// /// 表示当前页的 HtmlDocument，如果未加载任何页，则为 null。 ///
public HtmlDocument Document { get; }
事件

///

/// 在 WebBrowser 控件完成加载文档时发生。 ///

public event WebBrowserDocumentCompletedEventHandler DocumentCompleted;

///

/// 在 Control.Size 属性值更改时发生。 ///

public event EventHandler SizeChanged;
方法

///

/// 将指定的统一资源定位器 (URL) 处的文档加载到 WebBrowser 控件中，替换上一个文档。 ///

/// 要加载的文档的 URL。
public void Navigate(string urlString);
HtmlDocument 类的常用方法。

/// /// 活动脚本调用所返回的对象。 ///
/// 要调用的脚本方法的名称。
/// 要传递给脚本方法的参数。
public object InvokeScript(string scriptName, object[] args);

---

Step1：创建一个用于显示图形的网页。

初始显示的网页 echarts.html