AE的Annotation学习摘记

http://xg-357.blog.163.com/blog/static/36263124201151763512894/

IFeatureWorkspaceAnno pFWSAnno = (IFeatureWorkspaceAnno)SaveFeatWorkspace;  IAnnoClass pAnnoClass = (IAnnoClass)OldFeatureClass.Extension;

下面是我最近对Annotation研究的一些学习资料，收集于此，供大家学习之用。

一、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。

接下来的四个参数的前三个就是关键了，可以说，整个要素类的正常显示就是依赖它们。

二、使用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;

}

三、使用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);