使用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如下所示。请注意,此示例更改文本符号高度和正在引用的符号集合中的符号。文章来源:https://www.toymoban.com/news/detail-798067.html
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()调用的覆盖来优化功能的存储。文章来源地址https://www.toymoban.com/news/detail-798067.html
static void InsertAnno(string textString, MapPoint mapPoint, int symbolID, AnnotationFeatureClass featureClass)
{
var annoFCDef = featureClass.GetDefinition();
var symCol = annoFCDef.GetSymbolCollection();
//从符号集合中获取文本符号
var symbolIdentifier = (from s in symCol where s.ID == symbolID select s).FirstOrDefault();
var txtSymbol = symbolIdentifier.Symbol;
//创建行缓冲区
using (RowBuffer rowBuffer = featureClass.CreateRowBuffer())
{
Feature feature = featureClass.CreateRow(rowBuffer) as Feature;
AnnotationFeature annoFeat = feature as AnnotationFeature;
annoFeat.SetStatus(AnnotationStatus.Placed);
annoFeat.SetAnnotationClassID(0);
//设置文本和图形
CIMTextGraphic cimTextGraphic = new CIMTextGraphic();
cimTextGraphic.Text = textString;
cimTextGraphic.Shape = mapPoint;
//使用符号ID和文本符号设置符号引用
var symbolRef = new CIMSymbolReference();
symbolRef.SymbolName = symbolID.ToString();
symbolRef.Symbol = txtSymbol;
//在图形上设置符号引用,将其推回到特征中,然后存储。
cimTextGraphic.Symbol = symbolRef;
annoFeat.SetGraphic(cimTextGraphic);
feature.Store();
}
}
到了这里,关于ARCGIS PRO SDK Annotation 概念及操作的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!