ARCGIS PRO Annotation 专业概念及操作

? ? 使用Annotation的API功能。Annotation 的API功能位于ArcGIS.Core.dll中。Annotation API通常与地理数据库、地图创作和编辑结合使用。ArcGIS.Core.dll

??????ArcGIS.Core.Data.map API中的几乎所有方法都应该在MCT上调用。

? ? 一、Annotation featureclass

?????? ? ? ? ? ?1、从GeodatabaseGeodatabase数据库获取

?? ? ? ? ? ? ? ? ? ? 1）、通过要素类名称

using (AnnotationFeatureClass annoFeatureClass =geodatabase.OpenDataset<AnnotationFeatureClass>("AnnotationFeatureClassName"))
{
}

? ? ? ? ? ? ? ? ? ? ? ?2）通过注记要素类的ID

using (AnnotationFeatureClass annoFeatureClass =?
? ? ? ? ? ? ? ? ? ? geodatabase.OpenDataset<AnnotationFeatureClass>("1"))

{
}

? ? ? ?2、从地图加载图层获取
? ? ? ? ?? 1）、通过AnnotationLayer获取? ? ?

ArcGIS.Desktop.Mapping.Layer selectedLayer = MapView.Active.GetSelectedLayers().FirstOrDefault();
if (selectedLayer is ArcGIS.Desktop.Mapping.AnnotationLayer)
{
? using (Table table = (selectedLayer as AnnotationLayer).GetTable())
? {
? ? if (table is AnnotationFeatureClass)
? ? {
? ? ? AnnotationFeatureClass annoFeatureClass = table as AnnotationFeatureClass;
? ? }
? }
}

? ? ? ??? ? ? ? 2）、通过AnnotationFeature获取

ArcGIS.Desktop.Editing.Events.RowChangedEvent.Subscribe(args =>
{
? Row row = args.Row;
? if (row is AnnotationFeature)
? {
? ? using (AnnotationFeatureClass annoFeatureClass = row.GetTable() as AnnotationFeatureClass)
? ? {
? ? }
? }
}?

? 二、以表形式打开? ? ? ?

 AnnotationFeatureClass
using (Table table = geodatabase.OpenDataset<Table>("FeatureClassName"))
{
}

? ??三、将AnnotationFeatureClass作为要素类打开? ? ? ??

using (FeatureClass featureClass = geodatabase.OpenDataset<FeatureClass>("FeatureClassName"))
{
}

? ??四、注记要素类定义

? ? ? ? ? ?1、从地理数据库中打开注释要素类定义。Definition对象包含有关DataSet的元数据信息，通常在预期不会打开DataSet时使用。

AnnotationFeatureClassDefinition definition =?
? ?geodatabase.GetDefinition<AnnotationFeatureClassDefinition>("AnnotationFeatureClassName");

? ? ? ? ? ?2、从数据集中打开AnnotationFeatureClassDefinition。当数据集已打开并且引用可访问时使用此选项。

ArcGIS.Desktop.Mapping.Layer selectedLayer = MapView.Active.GetSelectedLayers().FirstOrDefault();
if (selectedLayer is ArcGIS.Desktop.Mapping.AnnotationLayer)
{
? using (AnnotationFeatureClass annoFC = (selectedLayer as AnnotationLayer).GetTable() as AnnotationFeatureClass)
? {
? ? AnnotationFeatureClassDefinition definition = annoFC.GetDefinition();
? }
}

? ? 五、遍历Annotation feature

?? ?使用注记要素类时，通过查询返回的要素属于AnnotationFeature类型。AnnotationFeature使用特定于注释的功能扩展了Feature的功能。首先，它提供了对注释功能中的CIMTextGraphic的访问。CIMTextGraphic是使用注释时修改的主要对象。此外，AnnotationFeature还为AnnotationClassID、LinkedFeatureID和注记状态提供了方便的set和get方法。在使用Feature对象时，通过AnnotationFeature更新这些属性比通过查找其字段索引更简单。如果注记要素类是使用基于GlobalID的关系类建立的，则LinkedFeatureID将为System.GUID类型，否则它将是一个长型。

???????与常规功能不同，AnnotationFeature的形状不会通过GetShape和SetShape进行常规更新。相反，当更新批注的CIMTextGraphic时，AnnotationFeature管理形状。该形状被设置为CIMTextGraphic的边界多边形。

????????在处理注释时需要记住的另一个概念是模式。默认情况下，使用一系列字段创建注记要素类，这些字段包含有关要素及其符号化的描述性信息。虽然这些字段是为新要素类创建的，但并非所有字段都是必需的。在ArcGIS Pro中，确保注记方案中存在的唯一字段是AnnotationClassID、SymbolID、Element、FeatureID或FeatureGlobalID(如果使用GlobalID关系)、ZOrder和Status以及系统OBJECTID和Shape字段。存储文本格式属性的所有其他字段(如文本字符串、字体名称、垂直对齐、水平对齐等)都是可选的。不能保证它们(在物理架构中)存在。此外，ArcGIS Pro注记模型不再具有粗体和斜体字段。它们已被替换为FontStyle字段。当批注描述字段存在时，它们与AnnotationFeature的CIMTextGraphic的内容保持同步。更新CIMTextGraphic将更新与该属性对应的行中的一个字段。同样，更新字段值也会更新CIMTextGraphic。如果在一个操作中同时更新字段和CIMTextGraphic，并且它们发生冲突，则CIMTextGraphic将优先。如果您正在编写创建或修改注释特征的工具，则必须考虑这些更改和重要概念。

在AnnotationFeatureClass上打开光标并更新AnnotationFeature的CIMTextGraphic如下所示。请注意，此示例更改文本符号高度和正在引用的符号集合中的符号。

QueryFilter qf = new QueryFilter();
qf.WhereClause = "OBJECTID < 100";
//Note: this is a non-recycling cursor off the Table, ~not~ the layer
using (RowCursor rowCursor = featureClass.Search(qf, false))
{
? geodatabase.ApplyEdits(() =>
? {
? ? while (rowCursor.MoveNext())
? ? {
? ? ? using (AnnotationFeature annoFeat = rowCursor.Current as AnnotationFeature)
? ? ? {
? ? ? ? CIMTextGraphic textGraphic = annoFeat.GetGraphic() as CIMTextGraphic;
? ? ? ? CIMSymbolReference symbolRef = textGraphic.Symbol;
? ? ? ? symbolRef.SymbolName = "1"; ?//change the symbol being referred to by the CIMTextGraphic
? ? ? ? CIMTextSymbol textSymbol = symbolRef.Symbol as CIMTextSymbol;

? ? ? ? textSymbol.Height = 6; //change the height of the text.

? ? ? ? annoFeat.SetGraphic(textGraphic);
? ? ? ? annoFeat.Store();
? ? ? }
? ? }
? });
}

? ? ?六、创建Annotation feature
? ? 下面演示了如何使用RowBuffer并在AnnotationFeatureClass中创建新的AnnotationFeature。将创建CIMTextGraphic，并指定Position、Text字符串和CIMTextSymbol属性。符号集合中的文本符号由ID引用。符号集合的符号ID是一个整数，但SymbolName属性是一个字符串，因此必须将其设置为字符串。AnnotationFeature将通过对Store()调用的覆盖来优化功能的存储。?

static void InsertAnno(string textString, MapPoint mapPoint, int symbolID, AnnotationFeatureClass featureClass)
{
? var annoFCDef = featureClass.GetDefinition();
? var symCol = annoFCDef.GetSymbolCollection();

? //get the text symbol from the symbol collection
? var symbolIdentifier = (from s in symCol where s.ID == symbolID select s).FirstOrDefault();
? var txtSymbol = symbolIdentifier.Symbol;

? //Create the row buffer
? using (RowBuffer rowBuffer = featureClass.CreateRowBuffer())
? {
? ? Feature feature = featureClass.CreateRow(rowBuffer) as Feature;
? ? AnnotationFeature annoFeat = feature as AnnotationFeature;

? ? annoFeat.SetStatus(AnnotationStatus.Placed);
? ? annoFeat.SetAnnotationClassID(0);

? ? //Setup the text graphic
? ? CIMTextGraphic cimTextGraphic = new CIMTextGraphic();
? ? cimTextGraphic.Text = textString;
? ? cimTextGraphic.Shape = mapPoint;

? ? //Setup the symbol reference with the symbol id and the text symbol
? ? var symbolRef = new CIMSymbolReference();
? ? symbolRef.SymbolName = symbolID.ToString();
? ? symbolRef.Symbol = txtSymbol;

? ? //Set the symbol reference on the graphic, push it back into the feature, and store.
? ? cimTextGraphic.Symbol = symbolRef;
? ? annoFeat.SetGraphic(cimTextGraphic);
? ? feature.Store();
? }
}