This document is archived and information here might be outdated.  Recommended version.


IAnnotationLayer Interface (ArcObjects .NET 10.8 SDK)
ArcObjects Help for .NET developers > ArcObjects Help for .NET developers > ArcObjects namespaces > Carto > ESRI.ArcGIS.Carto > Interfaces > IA > IAnnotationLayer Interface
ArcGIS Developer Help

IAnnotationLayer Interface

Provides access to members that control the annotation layer.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Members

Name Description
Read-only property AddErrorInfo The errors and the file and path of the GL*.log file which stores error information when Add is called in batch (using BeginAddElements and EndAddElements).
Method BeginAddElements Begins a batch process for adding elements to a graphics layer.
Method DoAddElements Adds a batch of elements to a graphics layer.
Method DoAddFeature Adds a feature and its corresponding element to a graphics layer.
Method DoAddNullElement Adds a feature and its corresponding element to a graphics layer.
Read/write property DrawUnplacedAnnotation Indicates if unplaced annotation is going to draw.
Method EndAddElements Ends the batch process for adding elements to a graphics layer.
Method SetupAttributeConversion Sets up attribute conversion parameters for batch conversion.
Read/write property UnplacedAnnotationColor Indicates the color with which unplaced annotation is drawn.

Classes that implement IAnnotationLayer

Classes Description
FDOGraphicsLayer A collection of properties for an annotation layer (feature data object graphics layer).

Remarks

IAnnotationLayer provides a fast mechanism for inserting annotation features into geodatabase annotation feature classes. Insertions performed via this interface are done as low level inserts that bypass polymorphic object insert behavior, therefore no events will be fired.

Adding annotation features or elements should always be done after calling the BeginAddElements method. After the features or elements are inserted, be sure to issue a call to the EndAddElements method.

If inserting annotation elements without attributes, use the DoAddElements method which takes an enumeration of GraphicElement objects. If inserting annotation elements with attributes, use the SetupAttributeConversion method to setup the field mapping between the input features and the target annotation feature class, then call DoAddFeature. DoAddFeature will add the element, the placement polygon shape and populate any attributes that are mapped. DoAddNullElement will add a null element to the feature class. The SetupAttributeConversion method cannot be called from Visual Basic. Instead, use the SetupAttributeConversion2 method on IFDOAttributeConversion to setup the field mapping. Field mapping should be setup after the BeginAddElements method is called.