ArcObjects Library Reference (Carto)  

IFDOGraphicsLayer Interface

Provides access to members that control properties of an annotation layer. Note: the IFDOGraphicsLayer interface has been superseded byIFDOGraphicsLayer2. Please consider using the more recent version.

Product Availability

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

When To Use

Use IFDOGraphicsLayer when you want to insert annotation elements or annotation features into a graphic feature class, such as a geodatabase annotation feature class.

Members

Description
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 EndAddElements Ends the batch process for adding elements to a graphics layer.
Method SetupAttributeConversion Sets up attribute conversion parameters for batch conversion.

CoClasses that implement IFDOGraphicsLayer

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

Remarks

IFDOGraphicsLayer 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 feature or element should always be done after calling the BeginAddElements method, and 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. 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.

See Also

IAnnotationFeature Interface