地图标注

地图标注：是表示制图对象的名称或数量及质量特征的文字和数字等文字语言。来说明制图对象的名称、种类、性质、和数量等具体特征。

　　ArcEngine中注记分为两种：标注（Label）、注记（Annotation）。Annotation以更复杂的方法和属性对要素图层进行标注，这个过程可以是自动的，不需用户干预，而且注记内容可以保存到地图数据库中。

　　AnnotationLayerPropertiesCollection对象是一个要素图层的属性，是一个标注集对象的集合。标注集是与某个要素图层相关联的，用于描述要素图层如何被标注，可以通过IGeoFeaturelayer中的AnnotationProperties属性获取。IAnnotationLayerPropertiesCollection接口提供了对保存在集合中的IAnnocationLayerProperties（LabelEngineLayerProperties、MaplexLabelEngineProperties）对象进行操作，通过该接口，开发者可以对集合中的组件进行添加、删除、排序和查询等操作。L　　　　　　　　abelEngineLayerProperties对象维持着一个要素图层的注记实例。

　　IAnnocationLayerProperties的WhereClause属性用于设置一个SQL语句，确定哪些要素可以被标注。

　　AnnotationMaximunScale和AnnotationMinMunScale用于设置文字标注的最大和最小范围。

　　LabelEngineLayerProperties对象也实现ILabelEngineLayerProperties接口，提供用于制作过程中的主要属性，设置文字符号、标注文字排放等，其中BasicOverposterLayerProperties用于设置标注文本如何被放置，以及处理文字之间的冲突。IBasicOverposterLayerProperties接口中的LineLabelPlacementPriorities用于设置标注文本的摆放路径的权重，LineLabelPosition用于设置标注文本的排放位置，PointPlacementPriorities用于设置一个与点相关的标注路径的权重等。

class MapMarker
    {
        private AxMapControl axMapControl;
        public MapMarker(AxMapControl _axMapControl)
        {
            axMapControl = _axMapControl;
        }
        /// <summary>
        /// 使用注记
        /// </summary>
        /// <param name="pGeoFeatureLyr">要注记的图层</param>
        /// <param name="AnnoField">注记内容</param>
        public void Annotation(IGeoFeatureLayer pGeoFeatureLyr, string AnnoField)
        {
            IGeoFeatureLayer pGeoFeatureLayer;//用 GeoFeatureLayer才能操作标注
            pGeoFeatureLayer = pGeoFeatureLyr;
            IAnnotateLayerPropertiesCollection pAnnoProps;//定义标注集对象的集合
            pAnnoProps = pGeoFeatureLyr.AnnotationProperties;
            pAnnoProps.Clear();//清除里面的集合，不知道是不是必须的
            IAnnotateLayerProperties pAnnoLayerPros;
            ILineLabelPosition pPosition;//控制Label相对位置
            ILineLabelPlacementPriorities pPlacement;//control placement position priorities for line labels
            IBasicOverposterLayerProperties pBasic;//Provides access to members that control the placement of labels relative to features using conflict detection
            ILabelEngineLayerProperties pLabelEngine;//可以控制标注的过程中的主要属性，设置文字符号，标注文字排放等

            ITextSymbol pTextSymbol;
            pTextSymbol = new TextSymbolClass();
            stdole.StdFont pFont;//定义字体吧，不知道
            pFont = new stdole.StdFontClass();
            pFont.Name = "Verdana";
            pFont.Size = 10;
            pTextSymbol.Font = pFont as stdole.IFontDisp ;
            pTextSymbol.Color = HsvColor(250,160,200);

            pPosition = new LineLabelPositionClass();
            pPosition.Parallel = false;//Label和线平行
            pPosition.Perpendicular = true;//Label和线垂直
            pPlacement = new LineLabelPlacementPrioritiesClass();
            pBasic = new BasicOverposterLayerPropertiesClass();
            pBasic.FeatureType = esriBasicOverposterFeatureType.esriOverposterPolyline;
            pBasic.LineLabelPlacementPriorities = pPlacement;
            pBasic.LineLabelPosition = pPosition;
            pLabelEngine = new LabelEngineLayerPropertiesClass();
            pLabelEngine.Symbol = pTextSymbol;
            pLabelEngine.BasicOverposterLayerProperties = pBasic;
            pLabelEngine.Expression = AnnoField;//注记的内容
            pAnnoLayerPros = pLabelEngine as IAnnotateLayerProperties;
            pAnnoProps.Add(pAnnoLayerPros);
            pGeoFeatureLayer.DisplayAnnotation = true;
            axMapControl .Refresh (esriViewDrawPhase .esriViewBackground ,null ,null );
        }
        private HsvColor HsvColor(int hue, int saturation, int val)
        {
            HsvColor hsvColor;
            hsvColor = new HsvColorClass();
            hsvColor.Hue = hue;
            hsvColor.Saturation = saturation;
            hsvColor.Value = val;
            return hsvColor;
        }
    }