ArcGIS Engine Style文件操作

对于一个GISer来说,地图,符号这些都应该有着比别人更深刻的理解和认识,作为平台软件都会提供一套自己的符号库,符号库里面根据类别和种类进行区分,因为点,线,面的自然存在和固有属性是不肯能让你用面状符号去渲染点和线的,学GIS的人,一般都会有分类的意识。

说我是一个ArcGIS 的用户,其实算不上,只能说是ArcGIS 软件的一个粉丝和使用者而已,我工作的大部分时间都是和ArcGIS 打交道,虽然跟一个东西时间长了,了解的也就越多,这句话是不错,但是对我来说还远远不够,我在告诉别人ArcGIS 的某一个功能是怎么用的时候,还总想告诉别人这是为什么,这点其实并不容易,但是我从来没放弃过,只要有时间,我自己也会去思考一些问题,思考如何能给 别人说的清楚,说的通俗易懂,不断的去学习,不断的看ArcGIS的英文资料,也不断的用鼠标在ArcGIS上点来点去,总希望发现奇迹,前几天用ArcGIS Engine 做一些符号化的功能,学写了一些,也有了自己的一些心得,希望能和大家分享。遇到了很多问题,比如经常在打开style文件的时候报错,有的时候不报错,有的时候报错,折腾了好长时间,最后发现,每次用完之后,需要将和符号相关的几个对象释放掉。现在开始看几个和符号化相关的接口:

IStyleGalleryStorage

该接口被ServerStyleGalleryClass和StyleGalleryClass实现,其中前者是用来针对ArcGIS Engine的serverstyle文件,后者是针对ArcGIS Desktop的style文件的。IStyleGalleryStorage 用来管理可以使用IStyleGallery编辑的Styles文件,我们可以将IStyleGalleryStorage看做一个存放Style文件的一个大的容器,每一个style文件由IStyleGalleryItems组成,通过IStyleGalleryStorage 我们可以添加、删除、更新对应的style文件。ESRI为我们提供了很多的默认的style文件,这些style文件的默认的存放路径C:\Program Files\ArcGIS\Styles下。该路径下有两种类型的文件,一种是文件扩展名称为.ServerStyle的文件,一种是文件扩展名称为style的文件。ServerStyle文件用于AE的开发,Style文件是ArcMap可以使用的样式文件。ESRI自带的工具里面有一种工具可以将style类型的文件转换为ServerStyle类型的文件,然后提供给ArcGIS Engine使用。

下面主要说明一下IStyleGalleryStorage对象的几个主要成员

AddFile; 

语法:Public Void AddFile(string path); 

Path:表示文件在本地的存放位置,C:\Program Files\ArcGIS\Styles\ Business.ServerStyle文件

该函数的意思是将一个指定位置的style文件添加到这个指定的容器里面,然后就可以通过IStyleGallery来对这些容器中的IStyleGalleryItem对象进行调用、处理等基本操作。

)DefaultStylePath: 是一个只读类型的属性,她返回的是ESRI中style文件默认的存放路径,这个跟ArcGIS软件的安装路径有关。返回值是一个String类型的变量,她的默认值可以是C:\Program Files\ArcGIS\Styles 这个是我本地计算机的DefualtStylePath的返回,因为我的ArcGIS软件安装在C盘。

)File属性  The file at the given index.  返回指定索引值的style文件的全路径名称、或者文件名称。

)FileCount :The number of files in the Style Gallery  返回 IStyleGalleryStorage中所包含的style文件的数量。

)RemoveFile(string path) 返回指定路径的style文件。

)TargetFile   The target output file for adding, updating and removing items. 这个是个可读、可写的属性。这个属性用来设置要编辑的目标文件,这个需要给定一个style文件的路径,如果本地计算机在指定的位置存在这个一个文件,那么系统就修改这个一个文件,如果本地计算机不存在这个一个文件,那么系统就将会在给定的位置创建一个新的style文件。当我们需要为IStyleGallery添加IStyleGalleryItem示例的时候,就需要指定这个属性,用来设置要编辑的IstyleGalleryStoragy中的某一个相对应的style文件。比如,在创建一个新的IstyleGalleryStoragy实例的时候,指定TargetFile属性,这个Style文件中就将默认的包含两个style文件,

一个是C:\Users\Administrator\AppData\Roaming\ESRI\ArcMap\Administrator.style文件,

一个是C:\Program Files\ArcGIS\Styles\ESRI.style文件

每一个文件都是由IStyleGalleryItem项组成的。并且每一个.style文件或.ServerStyle文件中的IStyleGalleryItem中的Item属性都有一个Class类型,然后根据不同的Class类型,添加后划分到对应的Class类型中,如下图所示:(关于Class类后面还有介绍) 

如上图所示的ESRI.style文件中,有很多类型的IstyleGalleryItem项,比如:Reference Systems/Maplex Labels/Shadows/Area Patches/Line Patches等等。每一个类都有若干数量的IStyleGalleryItem组成,比如上图中的Color Ramps项就是由右边的IStyleGalleryItem项组成的。

:IStyleGallery 

IStyleGallery可以看成是ISyleGalleryItem的容器,我们在上一节中已经提到我们可以把IStyelGalleryStorage看做一个.style和.ServerStyle文件的容器,并管理这些style文件,而这些style文件内是由ISyleGalleryItem项组成的。但是IStyleGaleryStorage却没有提供管理这些Style文件内的IStyleGalleryItem的借口,所以不能管理这些IstyleGalleryItem,这个时候就出现了IStyleGallery借口,由他来管理IStyleGalleryStorage容器内所有的IstyleGalleryItem项,比如,添加、删除、更新等操作。

下面接下来讲解一下他的几个属性以及他的方法:

ClassCount  只读属性,Number of classes in the Style Gallery。StyleGallery是有IStyleGalleryItem项组成的,这些IStyleGlleryItem分别属于不同的类,并且IStyleGalery默认的将IStyleGalleryItem分为12个类,如下图所示:

每一个类都包含有若干个IStyleGaleryItem,如下图所示

上图中,ESRI.Style文件包含22个类,当前我们选中North Arrows指北针类,然后右边就显示出来North Arrow类中所包含的IStyleGalleryItem项,可以看出有很多个这样的Item。

ClassCount属性也就是返回当前的StyleGallery中所包含的类的数目。在IStyleGallery中,不管我们包含多少个IStyle文件,IStyleGallery中包含的类的种类的数量都是一定的,即22个。也就是说,每一个Style文件中包含的类的数量以及类的名称都是一样的,我们也可以这样理解,当我们创建一个.style文件的时候,系统就自动在style文件中创建22个类,尽管这个时候,每个类中的IStyleGalleryItem都为空。

Class属性,通过调用.get_Class(int index) 来返回指定索引值的IStyleGaleryClass对象,请看下面一段代码

int StyleGalleryClassCouont = styleGellery.ClassCount; 

            IStyleGalleryClass styleGaleryClass = null; 

            for (int i = ; i < StyleGalleryClassCouont; i++) 

            { 

                styleGaleryClass = styleGellery.get_Class(i); 

                string name = styleGaleryClass.Name; 

            } 

关于IStyleGalleryClass 我们可以在以后讲解,这里只需要知道通过这个属性可以返回一个IStyleGaleryItem类的一个示例。

AddItem 语法如下所示:

Public void AddItem(IstyleGalleryItem item); 

描述:Adds an item to the target style file. 

CateGories属性

描述:The categories within the given class. 返回指定名称的Class中所包含的IStyleGallery所属的类别。

每一个IStyleGalleryClass类都包含有多个IstyleGalleryItem项,为了大体上区别这些IstyleGalleryItem项,我们又给这些IstyleGalleryItem项归类,也就是说,每一个IstyleGalleryItem都有这个Cagegories(种类、类别)这个属性。如下图所示:

)Clear  方法

语法:  Public void Clear(); 

Discription:Removes all styles from the Style Gallery. 

Items  返回满足指定参数的IstyleGalleryItems 

Discription: The style items from the specified style file, in the specified class and category. The style set and category may be blank to return all items. 

语法:IEnumStyleGalleryItem  get_Items(string className,string styleSet,string category) 

className:表示,IStyleGalleryItem所属的类

StyleSet:表示IstyleGalleryItem所存在的style文件

Category:IstyleGalleryItem 所属的类别。

参考代码:

            IStyleGallery styleGellery = new StyleGalleryClass(); 

            IStyleGalleryStorage styleGalleryStorage = styleGellery as IStyleGalleryStorage; 

            string tt = styleGalleryStorage.DefaultStylePath; 

            string iStyleFilePath = tt + "Civic.style"; 

            styleGalleryStorage.AddFile(iStyleFilePath); 

            string ClassName = "Color Ramps"; 

            string StyleCategory = "Default Ramps"; 

            IEnumStyleGalleryItem enumStyleGalleryItem = styleGellery.get_Items(ClassName, iStyleFilePath, StyleCategory); 

            IStyleGalleryItem StyleGalleryItemEnum = null; 

            ArrayList al = new ArrayList(); 

            while ((StyleGalleryItemEnum = enumStyleGalleryItem.Next()) != null) 

            { 

                al.Add(StyleGalleryItemEnum.Name); 

            } 

            int itemCount = al.Count; 

RemoveItem 

Discription: Removes an item from the target style file. 

这个方法挺简单,直接调用就可以了。

SaveStyle 

Discription: Saves the specified style to a file. If class is specified, only items in that class will be saved. 

这里面的有一个参数:FileName不是很理解

UpdateItem 

Discription: Updates an existing item in target style file.(可以看出,这里需要指定IStyleGalery的TargetFile属性,用来更新的操作也是更新这个属性指定的文件中的Item成员) 

IstyleGalleryItem 

Defination: Provides access to members that define items in the Style Gallery. 

Product Availability:Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. 

Description:Symbols and map elements are stored in the Style Gallery. Each symbol or map element has a unique ID that can be read from the item within the style gallery. A Name and Category are also properties of the items within the style gallery. These two fields, along with the Item itself, can be updated and changed as necessary. 

主要方法:

Category  :The category of the item. 

ID: Id for the item in the Style Gallery. 

Item: The symbol or map element to be stored in the Style Gallery item. 

Name :The name of the item in the Style Gallery. 

理解:IStyleGalleryItem项是IStyleGallery中最小的组成单元,即使是最小的单元,但是他也有她自己的属性,比如:Category、ID、Name等属性。我们也需要将IStyleGalleyItem理解成一个小的容器,因为每一个IStyleGalleryItem中都包含着一个属性Item属性,symbol或者地图都包含在这样一个IStyleGalleryItem项中。

参考代码:

IStyleGallery styleGallery = new StyleGallery(); 

IEnumStyleGalleryItem styleGalleryItem = (IEnumStyleGalleryItem)styleGallery;//从这一行可以看出一个IStyleGallery实例可以直接的转换为一个IEnumStyleGaleryItem对象

styleGalleryItem.Reset(); 

string itemName = styleGalleryItem.Next().Name; 

MessageBox.Show(itemName);

 注意:用AddItem、UpdateItem、RemoveItem之前,必须用到IStyleGalleryStorage接口的TargetFile属性。如果没有设置这个属性,就会报错,错误信息如下:

"对 COM 组件的调用返回了错误 HRESULT E_FAIL。" 错误代码:"-2147467259"

读取ServerStyle文件代码如下:

private string styleName = "3D Basic.ServerStyle"; 

public void ReadStyleServer() 

{ 

IStyleGallery tStyleGallery = new ServerStyleGalleryClass(); 

IStyleGalleryStorage tStyleGalleryStorage = tStyleGallery as IStyleGalleryStorage; 

tStyleGalleryStorage.AddFile(styleName); 

// tStyleGalleryStorage.TargetFile = styleName_TargetFile; 

IEnumStyleGalleryItem tStyleGalleryItems = tStyleGallery.get_Items("Marker Symbols", styleName, ""); 

tStyleGalleryItems.Reset(); 

IStyleGalleryItem tStyleGalleryItem = tStyleGalleryItems.Next(); 

int tIndex = ; 

try 

{ 

while (tStyleGalleryItem != null) 

{ 

string tName = tStyleGalleryItem.Name; 

tStyleGalleryItem.Name = tName + tIndex; 

tIndex++; 

tStyleGallery.UpdateItem(tStyleGalleryItem);//这个地方报错 

tStyleGalleryItem = tStyleGalleryItems.Next(); 

} 

} 

catch (System.Runtime.InteropServices.COMException ex) 

{ 

string tErrorMessage = ex.Message + 

ex.ErrorCode; 

} 

finally 

{ 

//释放这个接口,不然再次读取时会报错 

ReleaseCom(tStyleGalleryItems); 

ReleaseCom(tStyleGallery); 

} 

} 

private void ReleaseCom(object o) 

{ 

while (System.Runtime.InteropServices.Marshal.ReleaseComObject(o) > ) 

{ 

} 

} 

要想更新,必须用到TargetFile属性。具体为什么必须用这个,原因不明,可能是文件独占。所以只能走一个弯。思路如下:

()先把"3D Basic.ServerStyle"备份一个临时文件,备份的文件名称"Temp.ServerStyle"

()设置TargetFile,使其指向"Temp.ServerStyle"

()开始更新,更新完毕后,拷贝"Temp.ServerStyle"覆盖原来的"3D Basic.ServerStyle"

代码如下(只写数据跟新,不写文件拷贝和覆盖)

private string styleName_TargetFile = "Temp.ServerStyle"; 

private string styleName = "3D Basic.ServerStyle"; 

public void ReadStyleServer() 

{ 

IStyleGallery tStyleGallery = new ServerStyleGalleryClass(); 

IStyleGalleryStorage tStyleGalleryStorage = tStyleGallery as IStyleGalleryStorage; 

tStyleGalleryStorage.AddFile(styleName); 

tStyleGalleryStorage.TargetFile = styleName_TargetFile;

IEnumStyleGalleryItem tStyleGalleryItems = tStyleGallery.get_Items("Marker Symbols", styleName, ""); 

tStyleGalleryItems.Reset(); 

IStyleGalleryItem tStyleGalleryItem = tStyleGalleryItems.Next(); 

int tIndex = ; 

try

{ 

while (tStyleGalleryItem != null) 

{ 

string tName = tStyleGalleryItem.Name; 

tStyleGalleryItem.Name = tName + tIndex; 

tIndex++; 

tStyleGallery.UpdateItem(tStyleGalleryItem); 

tStyleGalleryItem = tStyleGalleryItems.Next(); 

} 

} 

catch (System.Runtime.InteropServices.COMException ex) 

{ 

string tErrorMessage = ex.Message + 

ex.ErrorCode; 

} 

finally

{ 

//释放这个接口,不然再次读取时会报错

ReleaseCom(tStyleGalleryItems); 

ReleaseCom(tStyleGallery); 

} 

} 

private void ReleaseCom(object o) 

{ 

while (System.Runtime.InteropServices.Marshal.ReleaseComObject(o) > ) 

{ 

} 

} 

不再报错,顺利运行。AddItem、RemoveItem方法类似。AddItem的时候,如果目标文件不存在,接口会自动创建目标文件。
上一篇:Javascript高级篇-面向对象的特性


下一篇:Python黑帽编程 3.2 ARP监控