从MapX到MapXtreme2004(原创:http://www.gisdn.com (GIS开发者网络) by 无忌)

网上的MapXtreme的资料实在太少了,MapXtreme编程基本上只能靠英文帮助和以前的Mapx的一些底子。我想写一个系列,把Mapx到Mapxtreme的学习历程记录下来。

一、工具选择
在Mapx中为控件选择工具比较迅速,也很直观,如下:
    Map1.CurrentTool = miZoomInTool
miZoomInTool是个枚举量,指定给CurrentTool属性即可,而且象在VB中,直接在等号之后就把备选项就列出来了,非常容易。
在MapXtreme中,这个不起眼的问题却搞得有点麻烦,主要是架构有点变化,设置位置很容易找
    MapControl1.MapTools.CurrentTool=
可是,要赋的值却比较麻烦,因为C#中并没有给出智能提示,而且在帮助和对象浏览器中也没有找到什么枚举值。帮助中说要赋String类型,试着
    MapControl1.MapTools.CurrentTool="ZoomInMapTool";
但是出错。于是查找帮助,了解MapXtreme中的架构,大致如此:MapTools属于MapControl控件的工具集合,其中已经包含了10个工具,debug中挨个求出如下:
    0:ZoomInMapTool
    1:ZoomOutMapTool
    2:PanMapTool
    3:CenterMapTool
    4:PointSelectionMapTool
    5:RadiusSelectionMapTool
    6:RectangleSelectionMapTool
    7:PolygonSelectionMapTool
    8:DistanceMapTool
    9:InfoMapTool
但是要选择工具,却不能用Index,也不能用某项的名字字符串,必须用toolname属性,而且必须这样
    MapControl1.MapTools.CurrentTool =ZoomInMapTool.Toolname;
因为Toolname是一个静态属性,所以必须用类名来引用,其他别的方式都不行。
看来,以后要用哪个工具,得先查到工具名称,然后才能指定了。
其他相关:
  1、Toolname是这几个类的特定属性,在其他的工具类中没有。
  2、如果界面中已经放置了同功能的操作控件并关联到MapControl控件,那么将会干扰到程序选择的工具。比如,既放了自带的移动控件,又有一个按钮可以设置移动工具,在点击自定义的按钮,选择移动工具时,那么,界面中的移动控件就会自动处于被按下的状态。这时,再用自定义的选择工具去设置别的功能就不管用了,怎么都是移动功能。所以,最好只要一个就行了。

二、图层操作
Mapx中基本的图层操作还是比较简单的,集中在对Layers和Layer的处理上,对别的没有太多要求。
在MapXtreme中,要完成类似功能,发生了一点变化,如下:
1、图层的显示
在MapXtreme中,图层的显示控制发生了奇怪的变化,有一个IsVisible属性,但它是只读的,不能通过它来改变图层的显示。要控制图层的显示与隐藏,可以通过设置Layer.Enable来控制。
2、图层的动态添加
代码如下:
    Catalog _catalog=MapInfo.Engine.Session.Current.Catalog;
    MapInfo.Data.Table _tempTable=null;
    Map _map=MapControl1.Map ;  
    TableInfo ti = TableInfoFactory.CreateTemp("临时");
    _tempTable = _catalog.CreateTable(ti);
    _map.Layers.Insert(0, new FeatureLayer(_tempTable));
可以看出:加图层实际就是加表;Catalog对象统管表的加载以及列举;
查帮助还可以了解:表信息其实还可以包括表的类型和坐标系。类型是指原生表,文本,access ...
上面的ti也可以这样取得,但是,上面的表默认是MeMTab,应该是内存中的吧。
    CoordSys cs=_map.GetDisplayCoordSys();
    TableInfo ti = TableInfoFactory.CreateTemp("临时",MapInfo.Data.TableType.Native,cs);
以上只能算是学习心得,肯定错误百出,但总比什么都没有强,至少能够提供一个思路。至于表如何保存,Mapx中的动画层和标签层在MapxTreme中如何对应,因为暂时不急用,先放着。

三、搜索图元Feature
A. 根据名称搜索图元
1、Mapxtreme的架构和Mapx有所变化,Mapx中,Layer包含Features,而Mapxtreme中则不是
2、Mapxtreme的例子中的查找,是通过Find对象来实现的,而Find对象的构造,需要指定Table和Colume,Table好办,FeatureLayer.table即可,而Colume通过FeatureLayer.table.tableinfo.colums["列名"]来指定。但是,关键问题,大多数的地图,并未设计过多的字段来供查询,查的其实就是个标题和label而已。
3、要用笨办法,遍历图层的features,通过这个方法
    foreach(Feature feature in lyr.table)
    {
    }
4、Feature派生自Object,包含一个Geometry属性,这个属性是各种几何图形对象的基类
   Geometry classes that derive from FeatureGeometry include: Point,MultiPoint, MultiCurve, MultiPolygon, FeatureGeometryCollection,Rectangle, RoundedRectangle, Ellipse, LegacyArc, and LegacyText.
5、通过如下方式引用feature对象
    ((MapInfo.Geometry.LegacyText)feature.Geometry).Caption
B. 通过search方法搜索
1、catalog的search方法可以按条件搜索图元(第一个图元)
    // also uses search for feature
    Feature fDEU = _catalog.SearchForFeature("europe", MapInfo.Data.SearchInfoFactory.SearchWhere("Country='DEU'"));
2、先利用SearchInfoFactory构造一个SearchInfo对象,指定其搜索属性:
    SearchAll: Returns all the rows.
    SearchNearest: Returns the rows with table geometries that are closest to the given search point.
    SearchWhere: Returns the rows specified by the given where Clause.
   SearchWithinDistance: Returns the rows where the table geometry iscontained within a buffer of the search point, rectangle or geometry.
    SearchWithinFeature: Returns the rows where the table geometry is contained within the search features's geometry.
    SearchWithinGeometry: Returns the rows where the table geometry is contained within the search geometry.
    SearchWithinRect: Returns the rows where the table geometry intersects the given rectangle.
    SearchIntersectsFeature: Returns the rows where the table geometry intersects with the search features's geometry.
    SearchIntersectsGeometry: Returns the rows where the table geometry intersects with the search geometry.
    SearchWithinScreenRadius: Creates a SearchInfo that returns the rows where the table geometry intersects a screen circle.
    SearchWithinScreenRect:Returns the rows where the table geometry intersects the given screen rectangle  
3、再调用search方法,将结果放到
    MultiResultSetFeatureCollection
    IResultSetFeatureCollection
4、或许还要设置视图
    MapInfo.Engine.Session.Current.MapFactory[0].SetView(fc.Envelope);
C. 通过选择工具来选择一个范围
1、需要控制选择的图层
2、选择的结果,通过MapInfo.Engine.Session.Current.Selections.DefaultSelection得到一个Selection对象
3、Selection对象,是一个IResultSetFeatureCollection的集合,每个对应一个表
4、对每一个IResultSetFeatureCollection,可以通过枚举器来遍历访问
    Selection sl =MapInfo.Engine.Session.Current.Selections.DefaultSelection;
    IResultSetFeatureCollection fc=sl[0];
    IFeatureEnumerator fn=fc.GetFeatureEnumerator();
    ListBox1.Items.Clear();
    while(fn.MoveNext())
      if(fn.Current.Geometry.GetType().ToString()=="MapInfo.Geometry.LegacyText")
        ListBox1.Items.Add(((MapInfo.Geometry.LegacyText)fn.Current.Geometry).Caption);

四、标注AutoLabel
好日子一去不复返了,原来总觉得Mapx很多地方设计得不是很自然,比如,feature和具体的feature之间的某些属性的关系,有时令人迷惑。但是,用了Mapxtreme,才感觉到Mapx的方便。真不知MapInfo怎么想的!原来的标注非常简单,layer有个autolabel属性,一设就可以了。现在呢:
    //James.Liu的代码
    Table table = Session.Current.Catalog.OpenTable("usa.tab");
    Map map = Session.Current.MapFactory.CreateEmptyMap(new Size(300, 300));
    LabelLayer layer = new LabelLayer();
    map.Layers.Add(layer);
    LabelSource source = new LabelSource(table);
    source.DefaultLabelProperties.Caption = "State_Name";
    layer.Sources.Append(source);

    //我的
    LabelLayer layer = new LabelLayer();
    MapControl1.Map.Layers.Add(layer);
    LabelSource source = new LabelSource(MapInfo.Engine.Session.Current.Catalog.GetTable("地名"));
    source.DefaultLabelProperties.Caption = "f_name";        //标注用到的那个字段名称
    layer.Sources.Append(source);
看Layer.Sources的架势,好像可以共用一个LabelLayer,试试,的确可以


五、自定义工具
参见月光宝盒的文章
http://jerry429.blogchina.com/2149736.html
参见 《MapXtreme2004_DevGuide_A4.pdf》   p155   Example 1: Writing a Server SIde Custom Tool
自己的体会:
1、要写一个自定义的事件参数,传递需要的信息
2、最好从一个MapTool派生新的工具类,而不要从现成的工具如点选工具派生,否则会带来很多问题。
感谢James.Liu给出的提示
http://www.mygis.com.cn/forum/dispbbs.asp?boardID=23&replyID=38340&ID=8090&skin=1
3、创建好的自定义工具,必须先建立实例,加到MapControl的Maptools中,才能被设置为当前工具。还有一点也很重要,Maptools似乎没有Viewstate,每次postback都会还原,所有在pageload中必须每次都加入新工具。
4、自定义工具的类型可以是多种多样,如下:
    To draw a rectangle:
        MapInfoWebRectangleStart
        MapInfoWebRectangleStop
    To process a click:
        MapInfoWebPointStart
        MapInfoWebPointStop
    To process panning of a map:
        MapInfoWebPanStart
        MapInfoWebPanStop
    To draw a circle:
        MapInfoWebCircleStart
        MapInfoWebCircleStop
    To draw a polyline:
        MapInfoWebDistanceStart
        MapInfoWebDistanceStop
    To draw a polygon:
        MapInfoWebPolygonStart
        MapInfoWebPolygonStop

六、对Table、Feature等的理解
A. Table
2004中,Table还是表,可以来自原始的mapinfo表,也可以来自数据库的二维表、文本等。Table的等价概念是feature集合,如下代码:
    (_tempTable as IFeatureCollection).Clear();
当然,可以通过枚举器,来逐个访问table的行,如下:
    Selection sl =MapInfo.Engine.Session.Current.Selections.DefaultSelection;
    IResultSetFeatureCollection fc=sl[0];       
    IFeatureEnumerator fn=fc.GetFeatureEnumerator();        //IFeatureCollection也有GetFeatureEnumerator
    ListBox1.Items.Clear();
    while(fn.MoveNext())
        if(fn.Current.Geometry.GetType().ToString()=="MapInfo.Geometry.LegacyText")
            ListBox1.Items.Add(((MapInfo.Geometry.LegacyText)fn.Current.Geometry).Caption);
当然,用
    foreach(Feature feature in tb)
也是毫无问题的,因而,table和结果集是等价的。  
B. Feature
Feature等价于表中的行。只与行有关,而与具体的图元的类型无关。换言之,Feature只是指图元对应的表行,而与图元的属性无关。
用Feature.Table可以引用到所属的表。
用Table.TableInfo可以引用到表的结构信息。
Feature具有的默认列,一般都包括obj,Mi_key,Mi_Style。obj我个人认为就是Feature对应的几何对象。用Feature.Geometry属性可以引用。
Feature.Geometry的类型是FeatureGeometry,它是各种具体图元(点线面文字...)的父类,Feature.Geometry属性所对应的,其实是具体的类。(我向这个属性赋点对象,发现没错)。
对Feature的使用,可以通过CataLog的SearchForFeature来查找,如下
    MapInfo.Engine.Session.Current.Catalog.SearchForFeature("Layer1",MapInfo.Data.SearchInfoFactory.SearchWhere("MI_Key='"+strKey+"'"))
由于ID其实并不唯一,所以,较好的查找对象是MI_Key。同时,Catalog还有其他的查找函数,如SearchNearest等。
加入Feature时,往往需要指定这些基本的信息,有多种加入方法,参见本系列的[5]。

七、标点心得
在Web上标点,首先要将图层所在文件夹的写权限放开。如果是普通的标点,可以这样:
    MapInfo.Data.Table tb=MapInfo.Engine.Session.Current.Catalog.GetTable("lyr");
    MapInfo.Geometry.Point pt = new MapInfo.Geometry.Point(MapControl1.Map.GetDisplayCoordSys(),e.point);
    MapInfo.Styles.SimpleVectorPointStyle vs = new MapInfo.Styles.SimpleVectorPointStyle();
    vs.PointSize = 25;
    vs.Color = Color.DarkMagenta;
    MapInfo.Data.Feature ft = new MapInfo.Data.Feature(pt,vs);
    tb.InsertFeature(ft2);
但是,如果有扩展的列,想要在标点时同时写上数据,将非常痛苦。查帮助,很自然得会用这个
    MapInfo.Data.Key ftrkey=tb.InsertFeature(ft);
    ...  //然后根据Key去进行操作
实际发现,那是不可能的事。虽然帮助中写得明明白白,可以返回一个Key,但无论如何,实际都不行。包括用它自己的Assign,Clone。

最后摸索出来的方法是:
A:第一种方法
    Feature ft2=new Feature(tb.TableInfo.Columns);
    ft2.Geometry=pt;
    ft2["f_name"]="aaa";
    ft2["ID"]="123";
    ft2["MI_Style"]=vs;
    tb.InsertFeature(ft2);
每个列都要赋值,缺一不可。
B:第二种方法
    MapInfo.Data.MICommand command2 = connection.CreateCommand();
    command2.CommandText = "Insert into Points (PersonID,MI_STYLE,Obj) values (@Id,@style,@obj)";
    command2.Parameters.Add("@Id",dr["PERSONID"].ToString()); //dr["PERSONID"].ToString()
    command2.Parameters.Add("@style", _bitmapSymbol);
    command2.Parameters.Add("@obj", pt);
    command2.Prepare();
    command2.ExecuteNonQuery();
错误的方法:
  试图修改Geometry.centerid

你可能感兴趣的:(http)