注记

注记

关注
发信
关注(28)粉丝(399)

【ESRI论坛6周年征文】ArcEngine注记（Anno/ Label/Element等）处理专题 -入门篇

原发表于ESRI中国社区，转过来。我的社区帐号：jhlong

----------------------------------------我是分割线，下面才是正文--------------------------------------------------------
 
1.说明
6周年征文

似乎就我这一篇ArcEngine开发的，搞开发的很少么？还是搞开发的都不善于言语？欢迎做ArcEngine开发的交流心得。

ArcGis里的注记，个人认为常用的有：
1.图层标注如arcmap里图层右键属性-labels内的label。这些有不少高级注记功能，其实ArcEngine都可以实现。看到论坛里也有不少没解决的于此相关的问题。具体看下面代码。
2.屏幕element。这类有文本、点、线、面等，且可设置各种样式和符号。这些不保存在数据库中，可以通过保存mxd的方式进行保存。
3.注记图层。就是IAnnoClass，存于数据库的注记。

以下代码也是针对以上3种注记类型进行说明。

个人文字描述不是太好，所以不多说，主要是代码加注释。需要时去找对应的大标题下的内容即可，总体不难理解。

文档看起来排版有点乱，附上下载，下载的可能不是最新的，以本帖为准。

http://pan.baidu.com/share/link?shareid=104303&uk=305065349

CSDN下载：
http://download.csdn.net/detail/jhlong12345/4768967

【ESRI论坛6周年征文】ArcEngine注记（Anno/ Label/Element等）处理专题 -入门篇-LMLPHP 【初级】ArcEngine注记处理专题.zip (45.79 KB)

新浪爱问下载：http://ishare.iask.sina.com.cn/f/34753842.html

值此论坛6周年之际，发出来庆祝论坛生日快乐。

主要适合初学者，也有一些高级功能及不常用的。自行选择。
代码应该都可以直接复制粘贴使用，不能用时请自己思考，还不行可以pm我。
如果看的过程中有任何疑问，请pm我。回帖也可以，但有可能漏掉。
初次写这种文章，如果有不对的或需要补充或描述不清晰的地方，烦请大家告知。

如果觉得对你有用，请多多支持。

 

请勿用于商业用途，请免费转载和分享，转载请注明作者和出处。

目录
1.说明        1
2.准备工作        2
2.1创建一个自定义颜色IRgbColor        2
2.2添加Element到地图窗口        2
2.3字体不随地图缩放变化        2
3.为图层增加注记表达式        2
4.注记表达式转图层要素        5
5.创建注记图层要素        6
6.创建文本注记TextElement        7
6.1创建一个字体        7
6.2创建文本注记样式        8
6.3.创建文本注记        8
7.创建面注记PolygonElement        8
7.1根据4点创建一个面        8
7.2.创建面符号        9
7.3.创建PolygonElement        9
8.创建线注记LineElement        9
8.1根据2点创建一条线        9
8.2.创建线符号        10
8.3.创建线注记        10
9创建一个点状注记（MarkerElement）        10
9.1根据XY创建一个点        10
9.2.创建MarkerElement        11
10.符号        11

内容整理自我的博客：http://jhlong12345.blog.163.com/ ... 631292012625336861/ 。
2.准备工作
2.1创建一个自定义颜色IRgbColor
下面会用到，很简单的一个小函数

/// <summary>

/// 自定义颜色，3个0是黑色，3个255是白色/// </summary>

/// <param name="r">红，取值0—255，下同</param>

/// <param name="g">绿.</param>

/// <param name="b">蓝</param>

/// <returns>IRgbColor</returns>

/// <remarks></remarks>

private static IRgbColor ColorCustom(int r, int g, int b)

{

IRgbColor myColor = new RgbColor();

myColor.Red = r;

myColor.Blue = b;

myColor.Green = g;

return myColor;

}

2.2添加Element到地图窗口
创建完Element后，用下面这句就可以加到当前地图窗口了。
(pMap as IGraphicsContainer) .AddElement(ele, 0);
2.3字体不随地图缩放变化
IMAP的ReferenceScale方法设置为0时，无论地图如何缩放，字体大小的屏幕距离不变，地图距离随比例尺变化。设置为其他比例尺如10000时，字体的地图距离就保持比例尺为10000时的高度，屏幕距离一直随比例尺变化。

3.为图层增加注记表达式

从注记表达式的文本文件中程序里读取并动态地增加注记。label expression 可以为简单的或vb脚本等。[]内的是字段名称。
例如：

Function FindLabel ([BH],[BM],[KD],[XZ])

FindLabel = FormatNumber([KD],,true,false,false)

if (IsNull([XZ]) or ([XZ] = "")) then FindLabel = [BH] &"/"& [BM]&chr()&chr()&FindLabel

if left([XZ],)= or left([XZ],)= then  FindLabel = [BH]&"G/"&[BM]&chr()&chr()&FindLabel

if left([XZ],)= or left([XZ],)= then  FindLabel = [BH] &"/"&[BM]&chr()&chr()&FindLabel

End Function

或者简单的一个字段：
[XZ]

这里的接口很少用，但是合理利用的话可以达到ArcMap里的高级效果

代码如下：

/// <summary>

/// 图层增加注记表达式

/// </summary>

/// <param name="map">The map.</param>

/// <param name="tcname">The tcname.</param>

public static void AddAnno(ILayer plyr , string tcname)

{

if (!System.IO.File.Exists(注记文件存储路径))

return;

IGeoFeatureLayer pGeoFeaLayer = (plyr as IFeatureLayer) as IGeoFeatureLayer;

IAnnotateLayerPropertiesCollection pAnoLayPC = pGeoFeaLayer.AnnotationProperties;

pAnoLayPC.Clear();

ILabelEngineLayerProperties pAnnoLayerProps = new LabelEngineLayerPropertiesClass();

(pAnnoLayerProps.BasicOverposterLayerProperties as IOverposterLayerProperties2).TagUnplaced = false;  ////是否覆盖，对应Arcmap：layer properties-》labels-》placement properties-》conflict detection ：：place overlapping labels

pAnnoLayerProps.SymbolID = ;

IBasicOverposterLayerProperties4 blp = pAnnoLayerProps.BasicOverposterLayerProperties asIBasicOverposterLayerProperties4;

//blp.PointPlacementMethod = esriOverposterPointPlacementMethod.esriAroundPoint;

blp.NumLabelsOption = esriBasicNumLabelsOption.esriOneLabelPerShape; ////每个图形只标注一个  label properties--palcement properties--duplicate labels

blp.PolygonPlacementMethod = esriOverposterPolygonPlacementMethod.esriAlwaysHorizontal; //// label properties--palcement properties--polygon settings

// blp.PlaceOnlyInsidePolygon = true;  ////保证在图形内部  label properties--palcement properties--only place label inside polygon

string annoExpression = GetAnnoExpression(注记文件存储路径);

if (annoExpression.ToUpper().IndexOf("FUNCTION") >= )

pAnnoLayerProps.IsExpressionSimple = false;

else

pAnnoLayerProps.IsExpressionSimple = true; //对应aArcMap的advanced选项

pAnnoLayerProps.Expression = annoExpression;

pAnnoLayerProps.Symbol = CreateTextSymbol();

pGeoFeaLayer.DisplayAnnotation = true;

}

/// <summary>

/// 根据注记文件存储路径获取标注表达式

/// </summary>

/// <param name="tcname">The tcname.</param>

/// <returns></returns>

public static string GetAnnoExpression(string注记文件存储路径)

{

StreamReader sr = new StreamReader(注记文件存储路径);

string annoExpression = string.Empty;

while (!sr.EndOfStream)

{

string text = sr.ReadLine();

if (annoExpression == string.Empty)

annoExpression = text;

else

annoExpression = annoExpression + "\r\n" + text;

}

return annoExpression;

}

4.注记表达式转图层要素
这段代码参见帮助文档，无需多解释，根据需要使用。

public static void ConvertLabelsToGDBAnnotationSingleLayer(IMap pMap, int layerIndex, bool featureLinked, stringlogpath)

{

string tcmc = string.Empty;

try

{

IConvertLabelsToAnnotation pConvertLabelsToAnnotation = new ConvertLabelsToAnnotationClass();

ITrackCancel pTrackCancel = new CancelTrackerClass();

//Change global level options for the conversion by sending in different parameters to the next line.

pConvertLabelsToAnnotation.Initialize(pMap,

esriAnnotationStorageType.esriDatabaseAnnotation,

esriLabelWhichFeatures.esriAllFeatures, true, pTrackCancel, null);

ILayer pLayer = pMap.get_Layer(layerIndex);

IGeoFeatureLayer pGeoFeatureLayer = pLayer as IGeoFeatureLayer;

if (pGeoFeatureLayer != null)

{

IFeatureClass pFeatureClass = pGeoFeatureLayer.FeatureClass;

IDataset pDataset = pFeatureClass as IDataset;

tcmc = GtMap.JNCommon.Engine.GetPureName(pDataset.Name);

IFeatureWorkspace pFeatureWorkspace = pDataset.Workspace as

IFeatureWorkspace;

//Add the layer information to the converter object. Specify the parameters of the output annotation feature class here as well.

pConvertLabelsToAnnotation.AddFeatureLayer(pGeoFeatureLayer, tcmc + "ZJ", pFeatureWorkspace,

pFeatureClass.FeatureDataset, featureLinked, true, true, true, true, "");

//Do the conversion.

pConvertLabelsToAnnotation.ConvertLabels();

string errorInfo = pConvertLabelsToAnnotation.ErrorInfo;

if (!string.IsNullOrEmpty(errorInfo))

LogWrite(logpath, errorInfo);

//IEnumLayer pEnumLayer = pConvertLabelsToAnnotation.AnnoLayers;

//Turn off labeling for the layer converted.

pGeoFeatureLayer.DisplayAnnotation = false;

//Add the result annotation layer to the map.

//pMap.AddLayers(pEnumLayer, true);

//Refresh the map to update the display.

IActiveView pActiveView = pMap as IActiveView;

pActiveView.Refresh();

iConvertCnt++;

if (iConvertCnt < )

{

IFeatureClass cls = pFeatureWorkspace.OpenFeatureClass(tcmc + "ZJ");

if (cls != null)

{

if ((cls.FeatureCount(null) == ) && (pFeatureClass.FeatureCount(null) > ))

{

pGeoFeatureLayer.DisplayAnnotation = true;

ConvertLabelsToGDBAnnotationSingleLayer(pMap, layerIndex, featureLinked, logpath);

}

}

}

}

}

catch (System.Exception ex)

{

}

}

5.创建注记图层要素
创建完文本注记TextElement后，可以选择以屏幕注记的形式加到屏幕上，也可以通过下面的方式转为注记图层要素：

IFeatureClass annocls = 获取注记图层

IDataset pDataset = annocls as IDataset;

ITransactions pTransactions = pDataset.Workspace as ITransactions;

pTransactions.StartTransaction();

IFDOGraphicsLayerFactory pFDOGLFactory = new FDOGraphicsLayerFactoryClass();

ILayer tmpLayer = pFDOGLFactory.OpenGraphicsLayer(pDataset.Workspace as IFeatureWorkspace, annocls.FeatureDataset, pDataset.Name);

IFDOGraphicsLayer pFDOGLayer = tmpLayer as IFDOGraphicsLayer;

IElementCollection pElementColl = new ElementCollectionClass();

pFDOGLayer.BeginAddElements();

……………………………… //创建text element

pElementColl.Add(element, );

…………………………….

////每新增100个提交下，最后再提交下。防止过多转换失败

if ((pElementColl != null) && (pElementColl.Count == ))

{

pFDOGLayer.DoAddElements(pElementColl, );

pFDOGLayer.EndAddElements();

pElementColl.Clear();

pTransactions.CommitTransaction();

pTransactions.StartTransaction();

pFDOGLayer.BeginAddElements();

}

if (pElementColl.Count > )

pFDOGLayer.DoAddElements(pElementColl, );

pFDOGLayer.EndAddElements();

pElementColl.Clear();

pTransactions.CommitTransaction();

6.创建文本注记TextElement
6.1创建一个字体

/// <summary>

/// 字体设置

/// </summary>

/// <param name="size">The size.</param>

/// <param name="fontname">The fontname.</param>

/// <returns>

/// IFontDisp

/// </returns>

public static stdole.IFontDisp GetIFontDisp(float size, string fontname)

{

string fontFamilyName = fontname;

FontStyle fontStyle = FontStyle.Regular;

Font font = new Font(fontFamilyName, size, fontStyle);

return OLE.GetIFontDispFromFont(font) as stdole.IFontDisp;

}

6.2创建文本注记样式

/// <summary>

///文本注记样式

/// </summary>

/// <param name="geometry">标注点,一个点即可</param>

/// <param name="text">标注内容</param>

/// <returns>

/// IElement

/// </returns>

public static ITextSymbol GetTextElement(IGeometry geometry, string text)

{

ITextSymbol textSymbol = new TextSymbolClass();

textSymbol.Color = ColorCustom(, , );

////不可以直接修改textSymbol.Font.Bold等属性，无效

stdole.IFontDisp font =  GetIFontDisp(9F, "宋体");

font .Bold = false;

font .Italic = false;

font .Strikethrough = false;

font .Underline = false;

textSymbol.Font = font;

textSymbol.HorizontalAlignment = esriTextHorizontalAlignment.esriTHALeft; ////水平

textSymbol.VerticalAlignment = esriTextVerticalAlignment.esriTVATop; ; ////垂直

return textSymbol ;

}

6.3.创建文本注记

ITextElement textElement = new TextElementClass();

textElement.ScaleText = true;

textElement.Symbol = GetTextElement();

textElement.Text = text;

IElement element = textElement as IElement;

element.Geometry = geometry;

7.创建面注记PolygonElement
7.1根据4点创建一个面

/// <summary>

/// 根据4个点创建图形,点序要顺时针

/// </summary>

/// <param name="pnt1">点1</param>

/// <param name="pnt2">点2</param>

/// <param name="pnt3">点3</param>

/// <param name="pnt4">点4</param>

/// <returns>IPolygon</returns>

public static IPolygon CreatePolygonBy4Points(IPoint pnt1, IPoint pnt2, IPoint pnt3, IPoint pnt4)

{

IPointCollection pPntCol = new PolygonClass();

object missing = Type.Missing; ////顺时针添加

pPntCol.AddPoint(pnt1, ref missing, ref missing);

pPntCol.AddPoint(pnt2, ref missing, ref missing);

pPntCol.AddPoint(pnt3, ref missing, ref missing);

pPntCol.AddPoint(pnt4, ref missing, ref missing);

pPntCol.AddPoint(pnt1, ref missing, ref missing); //// 为保持首尾相联，故将第一个点再添加一次

return pPntCol as IPolygon;

}

7.2.创建面符号

/// <summary>

/// 创建 面 符号

/// </summary>

/// <param name="r">The r.</param>

/// <param name="g">The g.</param>

/// <param name="b">The b.</param>

/// <returns>ISimpleFillSymbol</returns>

public static ISimpleFillSymbol CreateGeoSymbol(int r, int g, int b)

{

ISimpleFillSymbol psymbol = new SimpleFillSymbolClass() as ISimpleFillSymbol;

psymbol.Color = ColorCustom(r, g, b);

psymbol.Outline.Color = ColorCustom(r, g, b);

return psymbol;

}

7.3.创建PolygonElement

IElement pele = new PolygonElementClass();

pele.Geometry = pGeoCol as IGeometry;

(pele as IFillShapeElement).Symbol = CreateGeoSymbol(r, gD, b);

(pmap as IGraphicsContainer).AddElement(pele, );

8.创建线注记LineElement
8.1根据2点创建一条线

/// <summary>

/// 创建线

/// </summary>

/// <param name="pnt1">The PNT1.</param>

/// <param name="pnt2">The PNT2.</param>

public static void CreateLine( IPoint pnt1, IPoint pnt2)

{

IPolyline pline = new PolylineClass();

pline.FromPoint = pnt1;

pline.ToPoint = pnt2;

}

8.2.创建线符号

/// <summary>

/// 创建 线 符号

/// </summary>

/// <param name="r">The r.</param>

/// <param name="g">The g.</param>

/// <param name="b">The b.</param>

/// <returns>ILineSymbol</returns>

/// <remarks></remarks>

private static ILineSymbol CreateLineSymbol(int r, int g, int b)

{

ILineSymbol psymbol = new SimpleLineSymbolClass() as ILineSymbol;

psymbol.Color = ColorCustom(r, g, b);

psymbol.Width = ;

return psymbol;

}

8.3.创建线注记

IElement pele = new LineElementClass();

pele.Geometry = pPolyline as IGeometry;

(pele as ILineElement).Symbol = CreateLineSymbol(r, g, b);

(pmap as IGraphicsContainer).AddElement(pele, );

9创建一个点状注记（MarkerElement）
9.1根据XY创建一个点

/// <summary>

/// 根据x y创建新点

/// </summary>

/// <param name="dX">x坐标值</param>

/// <param name="dY">y坐标值</param>

/// <returns>返回点要素</returns>

/// <remarks></remarks>

public static IPoint GetPntFromXY(double dX, double dY)

{

IPoint pPnt = new PointClass();

pPnt.PutCoords(dX, dY);

return pPnt;

}

9.2.创建MarkerElement

IElement pele = new MarkerElementClass();

pele.Geometry = GetPntFromXY(x, y);

IMarkerSymbol sym = new SimpleMarkerSymbolClass();

sym.Color = ColorCustom(rDefault, gDefault, bDefault);

sym.Size = ;

(pele as IMarkerElement).Symbol = sym;

10.符号
Element创建好后可以赋个符号。这一块主要是符号化相关的东西，不做详细介绍，只简单创建一个。

ISimpleFillSymbol pSFillSym = new SimpleFillSymbolClass();

           pSFillSym.Style = esriSimpleFillStyle.esriSFSHollow;

           ISimpleLineSymbol pLineSymbol = new SimpleLineSymbolClass();

           pLineSymbol.Style=esriSimpleLineStyle.esriSLSNull;            pSFillSym.Outline = pLineSymbol;

           ISimpleMarkerSymbol Symbol = new SimpleMarkerSymbolClass();

           (pSymbol as IMarkerSymbol).Size = ;
04-28 01:07
Powered by LMLPHP ©2024 注记 0.080624