Annotation研究的一些學習資料

轉自chanyinhelv原文Annotation研究的一些學習資料

下面是我最近對Annotation研究的一些學習資料，收集於此，供你們學習之用。

1、Annotation要素類介紹

在GeoDatabase中有五種類型的要素類，即點、線、面、標註要素類和註記要素類。註記要素類涉及的較少，這裏不談。本文主要討論標註要素類的特徵，即Annotation FeatureClass的特性。

標註要素類是一種專門用於存儲和顯示文本或圖形元素的數據結構，在這以前，咱們只談過文本或圖像只能經過MXD的方式來存儲。標註要素類能夠是獨立的，也能夠與一個要素類相關聯。若是是獨立standalone的要素類，它就是其它要素類的一種背景；一旦與某個要素類相聯繫link，那麼標註要素顯示的內容就取決於與之相關的要素。

若是要新建一個標註要素類，不管是直接在工做空間中仍是在一個要素數據集中，都須要使用到IFeatureWorkspaceAnno的接口，下面咱們經過這個接口的CreateAnnotationClass方法來介紹標註要素類的一系列特性：

public IFeatureClass CreateAnnotationClass (
    string Name,
    IFields Fields,
    UID CLSID,
    UID EXTCLSID,
    string ShapeFieldName,
    string ConfigKeyword,
    IFeatureDataset dstFeatureDataset,
    IFeatureClass srcFeatureClass,
    object annoProperties,
    object referenceScale,
    object symbolCollection,
    bool autoCreate
);

Name是新建的標註要素類的名稱，這個字符串能夠隨意設置。
Fields是標註要素類的字段，與其它要素類不一樣的是，標註要素類的系統字段至關的多，這是由於標註字段涉及到存儲字符和修飾字符的Symbol樣式，所以，咱們也不建議用戶本身添加這些難以記憶的字段，在這種狀況下，咱們可使用一種簡單的方式實現：
IObjectClassDescription pOCDesc=New AnnotationFeatureClassDescription;
Fields=pOCDesc.RequiredFields;
也許有人會問，若是除了這些系統字段外，咱們還有本身的字段怎麼辦？這個很簡單，使用IFieldsEdit的方法再加自定義字段就能夠了。

CLSID和EXTCLSID兩個參數也是必須的，它們的含義很是有趣。咱們知道，GeoDatabase中的每一個對象都有個惟一標識符UID，系統是靠認證這個64位的隨機值來區分不一樣對象的，一樣的，要素類和要素類的擴展部分也有這麼個標識，只不過在通常狀況下咱們沒法看到這個UID值而已。如何產生這兩個值呢，也很簡單，使用：
CLSID=pOCDesc.InstanceCLSID;
EXTCLSID=pOCDesc.ClassExtensionCLSID;

ShapeFieldName是指一個要素類的Shape字段名，通常都是"SHAPE"。

ConfigKeyword通常不用設置，能夠設置爲空字符串。

dstFeatureDataset是指一個標註要素類被放置的要素數據集，固然，若是這個標註要素類直接放在工做空間中，這個參數將被設置爲null便可。

srcFeatureClass是標註要素類關聯的要素類，若是標註要素類是獨立的，則這個參數也能夠爲null。

接下來的四個參數的前三個就是關鍵了，能夠說，整個要素類的正常顯示就是依賴它們。

2、使用Annotation對象進行要素標註並設置標註位置

 AO中有兩種方法實現要素標註，一種是本身添加TextElement對象到文檔對象中，另外一種就是使用AO提供的Annotation對象，它的功能更增強大和豐富，它以更復雜的方法和屬性對要素圖層進行標註，標註的內容能夠保存到地理數據庫中。實現這個要素標註涉及到的對象包括IAnnotateLayerPropertiesCollection對象、IAnnotateLayerProperties對象和ILabelEngineLayerProperties對象，其實現代碼以下：（c#）

          public void CreateAnno（IFeatureLayer pFeatureLayer ）

         {

               IGeoFeatureLayer pGeoFLayer = pFeatureLayer as IGeoFeatureLayer;
                //獲得圖層的標註屬性集合對象
         IAnnotateLayerPropertiesCollection pAnnoLayerpRropColl = new AnnotateLayerPropertiesCollectionClass();
                pAnnoLayerpRropColl = pGeoFLayer.AnnotationProperties;

                //清空這個集合中的對象
                pAnnoLayerpRropColl.Clear();

                //新建一個圖層標註引擎對象，設置它的屬性
                ILabelEngineLayerProperties pLabelEngineLayerProp = new LabelEngineLayerPropertiesClass();
                pLabelEngineLayerProp.Expression = "[DYP]";

                //建立註記文本的文本符號
                ITextSymbol pTextSym = new TextSymbolClass();
                pTextSym.Color = GeoTool.GetColor(255, 0, 0);
                pTextSym.Size = 10;
                IFont font = new StdFontClass();
                font.Name = "Times New Roman";
                pTextSym.Font = (IFontDisp)font;
                pLabelEngineLayerProp.Symbol = pTextSym;

                //設置註記文本的位置
         IBasicOverposterLayerProperties pBasicOverposeterLayerProp = new BasicOverposterLayerPropertiesClass();
                pBasicOverposeterLayerProp.FeatureType = esriBasicOverposterFeatureType.esriOverposterPoint;
                pBasicOverposeterLayerProp.FeatureWeight = esriBasicOverposterWeight.esriNoWeight;
                pBasicOverposeterLayerProp.LabelWeight = esriBasicOverposterWeight.esriHighWeight;
                pBasicOverposeterLayerProp.BufferRatio = 0;

                //方式一：標註位於點特徵頂部
               //pBasicOverposeterLayerProp.PointPlacementOnTop = true;

                //方式二：標註環繞點特徵
   pBasicOverposeterLayerProp.PointPlacementMethod = esriOverposterPointPlacementMethod.esriAroundPoint;
                IPointPlacementPriorities pPointPlacement = new PointPlacementPrioritiesClass();
                pPointPlacement.AboveCenter = 0;
                pPointPlacement.AboveLeft = 0;
                pPointPlacement.AboveRight = 0;
                pPointPlacement.BelowCenter = 1;
                pPointPlacement.BelowLeft = 0;
                pPointPlacement.BelowRight = 0;
                pPointPlacement.CenterLeft = 0;
                pPointPlacement.CenterRight = 0;
                pBasicOverposeterLayerProp.PointPlacementPriorities = pPointPlacement;

                //方式三：標準旋轉必定角度
//pBasicOverposeterLayerProp.PointPlacementMethod = esriOverposterPointPlacementMethod.esriSpecifiedAngles;
                //double[] angle = new double[2];
                //angle[0] = 45;
                //angle[1] = 90;
                //pBasicOverposeterLayerProp.PointPlacementAngles = angle;
                
                pLabelEngineLayerProp.BasicOverposterLayerProperties = pBasicOverposeterLayerProp;

                IAnnotateLayerProperties pAnnoLayerProp = (IAnnotateLayerProperties)pLabelEngineLayerProp;
                pAnnoLayerpRropColl.Add(pAnnoLayerProp);

                pGeoFLayer.DisplayField = pLabelEngineLayerProp.Expression;
                pGeoFLayer.DisplayAnnotation = true;

        }

 

3、使用TextElement對象進行要素標註

使用TextElement對象進行要素標註能夠控制標註字體的樣式，標註的流程是首先獲取要素圖層中全部要進行標註的要素，而後對各個要素建立TextElement對象，並將其Text設爲要素的某個字段屬性，而Geometry是要素包括線的中間點。一下是在三維GlobeControl中的實現代碼如：（c#）

           //獲取圖層要素對象

            IFeatureCursor pFeatCurso = new FeatureCursorClass();
            pFeatCurso = pFeatClass.Search(null, true);
            IFeature pFeature = null;
            pFeature = pFeatCurso.NextFeature();
            while (pFeature != null)
            {
                //讀取要素
                .........................

                pFeature = pFeatCurso.NextFeature();
            }

          以上是有關讀取圖層要素的過程，這裏省略。

          添加標註代碼：

          說明：pArray中存放的是IGeometry對象

         public void AddElement(ArrayList pArray, IGlobeGraphicsLayer pGlobeGraphicsLayer)
        {
            //刪除上次添加的element
            IGraphicsContainer pGraphicsContainer = pGlobeGraphicsLayer as IGraphicsContainer;
            pGraphicsContainer.DeleteAllElements();
            pGlobeGraphicsLayer.UpdateAllElements();

            //設置顯示屬性
            IGlobeGraphicsElementProperties pGlobeGraphicsElementProperties = new GlobeGraphicsElementPropertiesClass();
            pGlobeGraphicsElementProperties.DrapeElement = true;
            pGlobeGraphicsElementProperties.FixedScreenSize = true;
            pGlobeGraphicsElementProperties.DrapeQuality = true;
            pGlobeGraphicsElementProperties.OrientationMode = esriGlobeGraphicsOrientation.esriGlobeGraphicsOrientationLocal;

            int hh;

            for (int i = 0; i < pArray.Count; i = i + 2)
            {
                IGeometry pGeometry = (IGeometry)pArray[i + 1];
                IPoint point = new PointClass();
                point = GeoTool.GetGeo(pGeometry);

                //添加點element對象（設置標註對象形狀）
                IElement pElement = new MarkerElementClass();              //定義爲標註性對象方便後續設置
                ISimpleMarkerSymbol pSimpleMarkerSymbol = new SimpleMarkerSymbolClass();   //設置形狀
                pSimpleMarkerSymbol.Style = esriSimpleMarkerStyle.esriSMSCircle;
                IMarkerSymbol pMarkerSymbol = pSimpleMarkerSymbol as IMarkerSymbol;        //設置顏色大小
                pMarkerSymbol.Color = GeoTool.GetColor(0, 255, 0);
                pMarkerSymbol.Size = 5;

                pElement.Geometry = point as IGeometry;
                IMarkerElement pMarkerElement = pElement as IMarkerElement;
                pMarkerElement.Symbol = pMarkerSymbol;
                pGlobeGraphicsLayer.AddElement(pElement as IElement, pGlobeGraphicsElementProperties, out hh);

                //添加文本element對象（標註的文字部分）
                ITextElement pTextElement = new TextElementClass();
                ITextSymbol pTextSymbol = new TextSymbolClass();
                pTextSymbol.Color = GeoTool.GetColor(255, 0, 0);
                pTextSymbol.Size = 10;
                IFontDisp pFontDisp = (IFontDisp)new StdFontClass();　　　　　        //設置字體
                pFontDisp.Name = "Times New Roman";
                pFontDisp.Bold = true;
                pFontDisp.Size = 10;
                pTextSymbol.Font = pFontDisp;
                pTextSymbol.HorizontalAlignment = esriTextHorizontalAlignment.esriTHALeft;
                pTextElement.Symbol = pTextSymbol;
                pTextElement.Text = pArray[i].ToString();
                ((IElement)pTextElement).Geometry = point as IGeometry;
                pGlobeGraphicsLayer.AddElement(pTextElement as IElement, pGlobeGraphicsElementProperties, out hh);
            }
        }

 

        對於二維中要加載TextElement標註，其建立TextElement的方法相同，主要是在於後面加載的方式不一樣而已，加載到的對象不一樣而已，三維GlobeControl中是加載到一個IGlobeGraphicsLayer中，二維中則是加載到MapControl的Map對象中。其核心代碼以下：

        IMap pMap = axMapControl1.Map;

        IActiveView pActiveView = pMap as IActiveView;

        IGraphicsContainer pGraphicsContainer = pMap as IGraphicsContainer;

        //將元素添加進Map對象中

       pGraphicsContainer.AddElement(pElement,0);

       pActiveView.PartialRefresh(esriViewDrawPhase.esriViewGraphics,null,null);