第二章　入门　
　１．工具（ＴｏｏｌＣｏｎｓｔａｎｔｓ）　
　在上一章里我们试着做了一个将地图放大的应用程序．在这章里，我们将接触到更多的工具，并介绍自定义工具．　
　ＭａｐＸ为开发人员提供一系列的工具，这些工具的作用各有不同，我们通过开发一个应用程序来了解这些工具的作用，至于这些工具的具体说明，可以在ＭａｐＸ的帮助文档中，通过查＂Ａｖａｉｌａｂｌｅ　Ｓｔａｎｄａｒｄ　Ｔｏｏｌｓ＂　看到相应的解释．一些ＭａｐＸ的相关资料也有介绍．　
　在．Ｎｅｔ编程环境中新建一个Ｃ＃的ＷｉｎｄｅｏｓＡｐｐｌｉｃａｔｉｏｎ（Ｗｉｎｄｏｗｓ应用程序）项目，然后在菜单中选择”项目／添加引用”，打开如下图的窗口，在窗口中选择ＣＯＭ标签，在组件名称列表中双击ＭａｐＩｎｆｏ　ＭａｐＸ　Ｖ５．单击＂确认＂按钮，将Ｍａｐ５控件加入到．Ｎｅｔ的工具箱中．　
　接着，将ＭａｐＩｎｆｏ　ＭａｐＸ　Ｖ５　控件画到窗体上，再在窗体上画一个ＣｏｍｂｏＢｏｘ控件ｃｏｍｂｏＢｏｘ１．如下图：　
　双击设计窗体，编写Ｆｏｒｍ１＿Ｌｏａｄ代码如下：　
ｐｒｉｖａｔｅ　ｖｏｉｄ　Ｆｏｒｍ１＿Ｌｏａｄ（ｏｂｊｅｃｔ　ｓｅｎｄｅｒ，　Ｓｙｓｔｅｍ．ＥｖｅｎｔＡｒｇｓ　ｅ）　
｛　
　ＡｒｒａｙＬｉｓｔ　ＴｏｏｌｓＬｉｓｔ＝ｎｅｗ　ＡｒｒａｙＬｉｓｔ（）；　
　ＴｏｏｌｓＬｉｓｔ．Ａｄｄ（ＭａｐＸＬｉｂ．ＴｏｏｌＣｏｎｓｔａｎｔｓ．ｍｉＡｒｒｏｗＴｏｏｌ）；　
　ＴｏｏｌｓＬｉｓｔ．Ａｄｄ（ＭａｐＸＬｉｂ．ＴｏｏｌＣｏｎｓｔａｎｔｓ．ｍｉＣｅｎｔｅｒＴｏｏｌ）；　
　ＴｏｏｌｓＬｉｓｔ．Ａｄｄ（ＭａｐＸＬｉｂ．ＴｏｏｌＣｏｎｓｔａｎｔｓ．ｍｉＬａｂｅｌＴｏｏｌ）；　
　ＴｏｏｌｓＬｉｓｔ．Ａｄｄ（ＭａｐＸＬｉｂ．ＴｏｏｌＣｏｎｓｔａｎｔｓ．ｍｉＰａｎＴｏｏｌ）；　
　ＴｏｏｌｓＬｉｓｔ．Ａｄｄ（ＭａｐＸＬｉｂ．ＴｏｏｌＣｏｎｓｔａｎｔｓ．ｍｉＰｏｌｙｇｏｎＳｅｌｅｃｔＴｏｏｌ）；　
　ＴｏｏｌｓＬｉｓｔ．Ａｄｄ（ＭａｐＸＬｉｂ．ＴｏｏｌＣｏｎｓｔａｎｔｓ．ｍｉＲａｄｉｕｓＳｅｌｅｃｔＴｏｏｌ）；　
　ＴｏｏｌｓＬｉｓｔ．Ａｄｄ（ＭａｐＸＬｉｂ．ＴｏｏｌＣｏｎｓｔａｎｔｓ．ｍｉＳｙｍｂｏｌＴｏｏｌ）；　
　ＴｏｏｌｓＬｉｓｔ．Ａｄｄ（ＭａｐＸＬｉｂ．ＴｏｏｌＣｏｎｓｔａｎｔｓ．ｍｉＴｅｘｔＴｏｏｌ）；　
　ＴｏｏｌｓＬｉｓｔ．Ａｄｄ（ＭａｐＸＬｉｂ．ＴｏｏｌＣｏｎｓｔａｎｔｓ．ｍｉＺｏｏｍＩｎＴｏｏｌ）；　
　ＴｏｏｌｓＬｉｓｔ．Ａｄｄ（ＭａｐＸＬｉｂ．ＴｏｏｌＣｏｎｓｔａｎｔｓ．ｍｉＺｏｏｍＯｕｔＴｏｏｌ）；　
　ｃｏｍｂｏＢｏｘ１．ＤａｔａＳｏｕｒｃｅ＝ＴｏｏｌｓＬｉｓｔ；　
｝　
以上代码通过一个数组ToolsList，将MapXLib的工具加入到comboBox1中.MapX还有一些其它的工具，
它们的作用是往地图上加上点，线，多边型和圆.因为这些工具要求有操作图层，一并在介绍图层的时候介绍.关于ArrayList的用法，请参考C#的有关资料.
接着，双击comboBox1，并编写代码如下
ｐｒｉｖａｔｅ　ｖｏｉｄ　ｃｏｍｂｏＢｏｘ１＿ＳｅｌｅｃｔｅｄＩｎｄｅｘＣｈａｎｇｅｄ（ｏｂｊｅｃｔ　ｓｅｎｄｅｒ，　Ｓｙｓｔｅｍ．ＥｖｅｎｔＡｒｇｓ　ｅ）　｛　
　ａｘＭａｐ１．ＣｕｒｒｅｎｔＴｏｏｌ＝（ＭａｐＸＬｉｂ．ＴｏｏｌＣｏｎｓｔａｎｔｓ）ｃｏｍｂｏＢｏｘ１．ＳｅｌｅｃｔｅｄＩｔｅｍ；　｝
应注意，在C#中必须要显式地把comboBox1的选择项目SelectedItem(数据类型为object)转换为ＭａｐＸＬｉｂ．ＴｏｏｌＣｏｎｓｔａｎｔｓ．因为ＴｏｏｌＣｏｎｓｔａｎｔｓ是ＭａｐＸ自己定义的一个枚举数据类型，Ｃ＃不能自动完成这种枚举成员变量到ｏｂｊｅｃｔ的数据转换．　
　编译执行程序，从ｃｏｍｂｏＢｏｘ１中选择不同的工具，在地图上进行操作，你可以了解到ＭａｐＸ工具集的强大功能．　
　实际上，ＭａｐＸ提供的工具集就好像Ｐｈｏｔｏｓｈｏｐ，ＡｕｔｏＣＡＤ的工具栏一样，为你提供了一些控制地图的工具．但是，在开发ＧＩＳ的时候，这些工具是不能完全满足要求的．所以，还应
该学会自定义工具．　
下面，通过一个在地图上测距的例子，来介绍一下如何在Ｃ＃下自定义ＭａｐＸ工具　
　如前所述建立一个Ｃ＃的Ｗｉｎｄｏｗｓ应用程序并将Ｍａｐｉｎｆｏ　ＭａｐＸ　Ｖ５　控件加到窗体上．并加入一个Ｂｕｔｔｏｎ控件ｂｕｔｔｏｎ１．将ｂｕｔｔｏｎ１的Ｔｅｘｔ属性改为＂测距＂，再在窗口中放上两个Ｌａｂｅｌ控件ｌａｂｅｌ１，ｌａｂｅｌ２，将它们的Ｔｅｘｔ属性设置为＂＂空字符串，如下图：　
　双击设计窗体，编写Ｆｏｒｍ１＿Ｌｏａｄ代码如下：　
ｐｒｉｖａｔｅ　ｖｏｉｄ　Ｆｏｒｍ１＿Ｌｏａｄ（ｏｂｊｅｃｔ　ｓｅｎｄｅｒ，　Ｓｙｓｔｅｍ．ＥｖｅｎｔＡｒｇｓ　ｅ）　
｛　
ａｘＭａｐ１．ＣｒｅａｔｅＣｕｓｔｏｍＴｏｏｌ（１００，ＭａｐＸＬｉｂ．ＴｏｏｌＴｙｐｅＣｏｎｓｔａｎｔｓ．ｍｉＴｏｏｌＴｙｐｅＰｏｌｙ，　
ＭａｐＸＬｉｂ．ＣｕｒｓｏｒＣｏｎｓｔａｎｔｓ．ｍｉＣｒｏｓｓＣｕｒｓｏｒ，ｎｕｌｌ，ｎｕｌｌ，ｎｕｌｌ）；　｝　
　在加载窗口的时候，我们定义了一个工具．它的编号是１００（不要和ＭａｐＸ本身的工具编号重复），它的类型是一个多义线，采用十字光标．　
　关于此函数的用法，建议查看ＭａｐＸ的开发手册和相关资料．　
　现在我们定义了一个编号为１００的工具，可以在程序中使用它了．双击设计窗体中的ｂｕｔｔｏｎ１，编写它的Ｃｌｉｃｋ事件处理代码如下：　
ｐｒｉｖａｔｅ　ｖｏｉｄ　ｂｕｔｔｏｎ１＿Ｃｌｉｃｋ（ｏｂｊｅｃｔ　ｓｅｎｄｅｒ，　Ｓｙｓｔｅｍ．ＥｖｅｎｔＡｒｇｓ　ｅ）　
｛　
　ａｘＭａｐ１．ＣｕｒｒｅｎｔＴｏｏｌ＝（ＭａｐＸＬｉｂ．ＴｏｏｌＣｏｎｓｔａｎｔｓ）１００；　
｝　
　现在编译运行，单击ｂｕｔｔｏｎ１，就可以在地图上使用这个工具了．但是还有一部分重要的代码没有完成：测距！　
　完成测距功能的代码在Ｃ＃使用ＭａｐＸ开发ＧＩＳ中非常具有代表性，也比较有难度．我在首次使用Ｃ＃＋ＭａｐＸ开发ＧＩＳ的时候，被这个问题困扰了很久．项目经理也来研究，过两天说有结果了，但他给出的例子根本就行不通．当然，会了就不难了．其实，也很简单．　
　首先，在窗口类中声明两个私有全局变量以保存测出的距离和总距，注意声明代码的位置：　
ｐｕｂｌｉｃ　ｃｌａｓｓ　Ｆｏｒｍ１　：　Ｓｙｓｔｅｍ．Ｗｉｎｄｏｗｓ．Ｆｏｒｍｓ．Ｆｏｒｍ　
｛　
　ｐｒｉｖａｔｅ　ＡｘＭａｐＸＬｉｂ．ＡｘＭａｐ　ａｘＭａｐ１；　
　ｐｒｉｖａｔｅ　Ｓｙｓｔｅｍ．Ｗｉｎｄｏｗｓ．Ｆｏｒｍｓ．Ｂｕｔｔｏｎ　ｂｕｔｔｏｎ１；　
　ｐｒｉｖａｔｅ　Ｓｙｓｔｅｍ．Ｗｉｎｄｏｗｓ．Ｆｏｒｍｓ．Ｌａｂｅｌ　ｌａｂｅｌ１；　
　ｐｒｉｖａｔｅ　Ｓｙｓｔｅｍ．Ｗｉｎｄｏｗｓ．Ｆｏｒｍｓ．Ｌａｂｅｌ　ｌａｂｅｌ２；　
　／／／　＜ｓｕｍｍａｒｙ＞　
　／／／　必需的设计器变量。　
　／／／　＜／ｓｕｍｍａｒｙ＞　
　ｐｒｉｖａｔｅ　Ｓｙｓｔｅｍ．ＣｏｍｐｏｎｅｎｔＭｏｄｅｌ．Ｃｏｎｔａｉｎｅｒ　ｃｏｍｐｏｎｅｎｔｓ　＝　ｎｕｌｌ；　
gis字符串是什么
　ｐｒｉｖａｔｅ　ｄｏｕｂｌｅ　Ｄｉｓ＝０，ＤｉｓＳｕｍ＝０；　
．．．　
．．．
现在来编写工具的事件.注意，在MapX画多义线的时候，它触发消息的方式和一般的工具是不同的，首先，它并不是用鼠标一点击就完成了的，还可以继续画下去，所以，不应该在MapX控件的ToolUsed事件中编写，而应该在PolyToolUsed事件中实现测距.代码如下:
ｐｒｉｖａｔｅ　ｖｏｉｄ　ａｘＭａｐ１＿ＰｏｌｙＴｏｏｌＵｓｅｄ（ｏｂｊｅｃｔ　ｓｅｎｄｅｒ，　
ＡｘＭａｐＸＬｉｂ．ＣＭａｐＸＥｖｅｎｔｓ＿ＰｏｌｙＴｏｏｌＵｓｅｄＥｖｅｎｔ　ｅ）　
｛ 
　ＭａｐＸＬｉｂ．ＰｏｉｎｔｓＣｌａｓｓ　ｐｔｓ＝ｎｅｗ　ＭａｐＸＬｉｂ．ＰｏｉｎｔｓＣｌａｓｓ（）；　
　ｓｗｉｔｃｈ（ｅ．ｆｌａｇｓ）　
　｛　
  ｃａｓｅ　（ｉｎｔ）ＭａｐＸＬｉｂ．ＴｏｏｌＦｌａｇＣｏｎｓｔａｎｔｓ．ｍｉＴｏｏｌＩｎＰｒｏｇｒｅｓｓ：　
  　ｐｔｓ＝（ＭａｐＸＬｉｂ．ＰｏｉｎｔｓＣｌａｓｓ）ｅ．ｐｏｉｎｔｓ；　
Ｄｉｓ＝ａｘＭａｐ１．Ｄｉｓｔａｎｃｅ（ｐｔｓ．＿Ｉｔｅｍ（ｐｔｓ．Ｃｏｕｎｔ－１）．Ｘ，　
ｐｔｓ．＿Ｉｔｅｍ（ｐｔｓ．Ｃｏｕｎｔ－１）．Ｙ，　
ｐｔｓ．＿Ｉｔｅｍ（ｐｔｓ．Ｃｏｕｎｔ）．Ｘ，　
ｐｔｓ．＿Ｉｔｅｍ（ｐｔｓ．Ｃｏｕｎｔ）．Ｙ）；　
  　ＤｉｓＳｕｍ＋＝Ｄｉｓ；　
  ｂｒｅａｋ；　
  ｄｅｆａｕｌｔ：　
  　Ｄｉｓ＝０；　
  　ＤｉｓＳｕｍ＝０；　
  ｂｒｅａｋ；　
　｝　
　ｌａｂｅｌ１．Ｔｅｘｔ＝＂距离：＂＋Ｄｉｓ．ＴｏＳｔｒｉｎｇ（＂＃．００＂）；　
　ｌａｂｅｌ２．Ｔｅｘｔ＝＂总距＂＋ＤｉｓＳｕｍ．ＴｏＳｔｒｉｎｇ（＂＃．００＂）；　
｝
这段代码虽短.但要注意的地方很多.
首先，定义一个MapXLib.PointsClass类型的变量pts，注意，是PointsClass，不是PointClass.前者是点集，后者是点.为什么要增加那么一个变量呢?因为MapX的PolyToolUsed事件的返回参数e的成员points不是MapXLib.PointsClass类型，而是object.类型.所以需要这么一个变量来转换它，当然，你也可以在程序使用pts的地方直接使用(MapXLib.PointsClass)e.points，但那样一来程序就比较难懂了;
其次，要判断事件的标识e.flags的值，它指出工具当前的状态，是刚开始画多义线呢，还是正在画多义线，或者已经结束了，或者结束退出.我们只要在画的时候测距就可以了.其它时候将距离和总距都设置为0;
接着，还要注意的是e.points的点数据保存方式,e.points首先是一个object，当在画多义线的时候，它被初试化为一个MapXLib.PointsClass的变量，并以二维数组的方式保存点集.这个数组是从1开始的，而不是从0开始的.它保存了多义线上每个转折点的坐标，鼠标每点一下，就增加一个新的数据到点集，我们计算最后一条直线长度，应该从这个数组的末尾往前取.计算好距离以后再加入到总距中.许多测距的程序例子都要做一个循环，其实是不必要的.
最后，请注意数字转换到字符串的格式问题.在这个例子中我们保留两位小数.
补充一点，因为没有设置地图的地理坐标系统，所以测出来的距离单位是英里，如果要改为公里，把MapX控件的MapUnit属性改为miUnitKilometer就可以了.要提高测量精度，除了可以通过转换格式的时
候增加小数位，还应该注意到地图的测绘精度.否则，再多的小数位也是没有意义的.
练习
1.建立一个应用程序，加入MapX控件和一个ComboBox控件，两个:Label控件，在ComboBox 中加入第一个例子中的所有工具和测距工具，在ComboBox中选择测距工具时实现测距功能.
2.将测距工具的光标改成箭头光标.并以米为单位显示测距数据.

版权声明：本站内容均来自互联网，仅供演示用，请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198，我们将在24小时内删除。