NShape(开源矢量图形编辑器) 入门（一）

NShape(矢量图形编辑器) 入门（一）

  NShape是基于.Net平台下的一款开源的winforms图表设计框架，使用C#编写。NShape允许用户查看、注释，修改和创建流程图、接线图或项目图等图表。Nshape有一个双重许可证，允许它在开源项目中免费使用，在商业项目中则需要支付许可证费用。

软件获取

1. CodePlex网站
2. GitHub

安装

1.解压文件后，进入安装目录下

Source

文件夹，打开

NShape.sln

工程文件，编译工程文件。

2.新建一个文件夹，将编译文件后获得的dll文件存放于此。

3.启动Visual Studio，将

Dataweb.NShape.dll

，

Dataweb.NShape.WinFormsUI.dll

添加到工具箱，添加dll控件教程见：Visual Studio 添加dll控件。

创建一个NShape桌面应用程序

1.新建一个Visual C# Window 窗体应用程序，命名为

BaseNShapeApplication

。

  ! NShape项目要求使用完整的 .Net Framework 版本,如果项目是使用 .Net Framework Client 版本，请切换成完整版。

2.添加如下引用：

Dataweb.NShape.dll

，

Dataweb.NShape.WinFormsUI.dll

，

Dataweb.NShape.GeneralShapes

。

3.在winForm窗口内添加

MenuStrip

控件，于控件内添加文件打开子集。

4.继续往窗体内添加以下控件：

Display

，

Project

，

DiagramSetController

，

CachedRepository

，

XmlStore

控件，设置

Display

控件

Dock

属性为为

Fill

，随后按照以下顺序对控件进行关联绑定操作：

5.双击窗体标题栏进入

Form1_Load

方法，添加代码：

private void Form1_Load(object sender, EventArgs e)
{
	project1.LibrarySearchPaths.Add(Application.StartupPath);
	project1.AutoLoadLibraries = true;
	
	/* NShape保存格式文件".nspj"会存储GeneralShapes控件标识，版本信息.
	 * 因此如果不进行注册的话，会无法打开不同版本时期创建的文件。
	 * 其中NShape Demo文件大部分均为1.0.0.0 - 2.0.0.0时期文件，因此建议提前注册。*/
	project1.AddLibrary(typeof(Ellipse).Assembly, false);
	project1.AutoGenerateTemplates = true;
	
	//在新建project1对象时，必须为其添加名称，默认project对象不会生成名称，但却需要名称。
	project1.Name = "New Templet";
	project1.Create();
	display1.CreateDiagram("Diagram 1");
}
           

  完成后运行程序会得到以下界面：

6.双击菜单栏下

打开

选项，进入

打开ToolStripMenuItem_Click

方法，添加代码：

private void 打开ToolStripMenuItem_Click(object sender, EventArgs e)
{
	OpenFileDialog openfileDialog = new OpenFileDialog();
	openfileDialog.Filter = "*.nspj|*.nspj";
	if (openfileDialog.ShowDialog() == DialogResult.OK)
	{
		//在打开新文件前需要先关闭原先打开的对象
	    if(project1.IsOpen)
	    {
	        project1.Close();
	    }
	    
	    FileInfo fileInfo = new FileInfo(openfileDialog.FileName);
	    xmlStore1.DirectoryName = fileInfo.DirectoryName;
	    xmlStore1.FileExtension = fileInfo.Extension.TrimStart('.');
	    project1.Name = fileInfo.Name.Replace(fileInfo.Extension, "");
	    project1.Open();
	    
	    //NShape程序允许存在多个Diagrams对象，但只能显示其中一个。本Demo默认显示第一个对象。
	    var diagrams = project1.Repository.GetDiagrams();
	    foreach (var item in diagrams)
	    {
	        display1.Diagram = item;
	        break;
	    }
	}
}
           

  完成后运行程序可以得到以下界面：