ArcEngine 样式对象StyleGallery的使用详解

        ArcMap里面存在很多预定义的样式对象，比如颜色、图例和各种符号等。用户也可以新建自己的样式对象，来满足实际开发的特殊需要。在进行arcgis engine 二次开发的过程中，用户可直接使用这些样式对象，以丰富制图内容，简化制图过程。

        样式通常按照功能被分为多个类型。这些样式都被保存在一个style文件中，读者可在<ArcGIS 安装目录>\Bin\Styles 文件夹中寻找到这些Style文件。一个样式由多个样式条目(StyleGalleryItem）组成，这些Style条目提供了得到单个地图元素或符号的方法。相似的条目被组织成样式类(StyleGalleryClass)。一个样式类中的条目可依据类型的差异进行分组(Categories)。在AE中样式类需要和AxSymbologyControl控件配合使用。

       StyleGallery是一个与文档对象相关的Style集合对象，它代表了一个Style文件，利用该对象，开发人员可以将一个style文件的样式取出来供系统使用。StyleGallery 类默认实现了IStyleGallery接口，该接口定义了操作一个样式中的种类、样式类和样式条目的方法和属性，如添加、删除、更新样式条目和载入新的Style文件。

       Class属性可使用一个给定的索引值得到Style文件中的某个StyleGalleryClass对象；ClassCount属性用于返回这个Style对象中所有样式类数目；Categories属性可返回一个样式类中的样式种类；Items 属性可以在给定样式类名、Style文件路径和种类名称的情况下，返回符合这些条件的样式条目集对象。下面的示例代码用于获取样式条目。

    private void  StyleGalleryDemo()
        {
            IStyleGallery pStyleGallery = new StyleGalleryClass();
            pStyleGallery.LoadStyle(@"C:\Program Files\ArcGIS\Styles\ESRI.Style", "");
            for(int i=0;i<=pStyleGallery.ClassCount;i++)
            {
                MessageBox.Show(pStyleGallery.get_Class(i).Name);
            }
            IEnumStyleGalleryItem pEnumStyleGalleryItem;
            IStyleGalleryItem pStyleGalleryItem;
            pEnumStyleGalleryItem = pStyleGallery.get_Items("Scale Bars", @"C:\Program Files\ArcGIS\Styles\ESRI.Style", "hollowscalebar");
            pEnumStyleGalleryItem.Reset();
            pStyleGalleryItem = pEnumStyleGalleryItem.Next();
            while(pStyleGalleryItem !=null)
            {
                MessageBox.Show(pStyleGalleryItem.Name);
                pStyleGalleryItem = pEnumStyleGalleryItem.Next();
            }
        }

       StyleGallery对象还实现了IStyleGalleryStorage接口，该接口提供了在StyleGallery对象中获得一个Style文件指针的方法，也提供了让开发人员能够添加或删除Style文件的方法。

       DefaultStylePath属性将会返回Style文件的缺省目录；TargetFile属性允许开发人员新建一个Style文件作为添加、删除和更新样式条目的目标文件；CanUpdate用于确定是否允许改变一个Style文件。

      下面是一个新建Style文件并插入一个StyleGalleryItem的例子，执行完这段代码后，在D盘目录下将出现一个test.style文件，若使用ArcMap样式管理器来查看该文件，在ArcMap的Colors样式类中，将会看到所添加的颜色样式条目。使用该函数须添加引用using ESRI.ArcGIS.Framework。

private void AddStyleItem()
        {
            IStyleGallery pStyleGallery=new StyleGalleryClass();
            IRgbColor pRgbColor = new RgbColorClass();
            pRgbColor.Red = 255;
            pRgbColor.Green = 0;
            pRgbColor.Blue = 0;
            IStyleGalleryItem pStyleItem = new StyleGalleryItemClass();
            pStyleItem.Name = "Red";
            pStyleItem.Category = "Default";
            pStyleItem.Item = pRgbColor;
            IStyleGalleryStorage pStyleStorage = pStyleGallery as IStyleGalleryStorage;
            pStyleStorage.TargetFile = @"D:\test.style";
            pStyleGallery.AddItem(pStyleItem);
        }

   希望这篇文章能够帮助到你们！也希望得到你们的支持！

欢迎关注微信公众号“GIS带我奔跑”获取更多GIS前沿开发技术、行业应用和最新资讯。

​​​

​