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


ISymbolCollection Interface (ArcObjects .NET 10.5 SDK)
ArcObjects Library Reference (Display)  

ISymbolCollection Interface

Provides access to members that control a collection of symbols and id pairs. Note: the ISymbolCollection interface has been superseded byISymbolCollection2. Please consider using the more recent version.

Product Availability

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

Members

Description
Method Next Returns the next symbolID-symbol pair in the collection.
Method Remove Removes the symbolID-symbol pair in the collection.
Method RemoveAll Removes all the symbolID-symbol pairs in the collection.
Method Replace Replaces the symbol associated with the symbolID.
Method Reset Prepares the collection for Next to be called.
Read/write property Symbol The symbol associated with the symbolID.

CoClasses that implement ISymbolCollection

CoClasses and Classes Description
SymbolCollection Collection of symbols and id pairs.

Remarks

ISymbolCollection provides access to the members of the symbol collection.  This interface is most commonly used to maintain the symbol collection of an AnnotationFeatureClassExtension.  Care should be taken when modifying symbols in the collection of an AnnotationFeatureClassExtension.  Updating a TextSymbol property for an existing symbol in use that results in a change in the size or shape of a TextElement will result in a disconnect between the drawn symbol and the feature geometry.  This can be resolved by updating the out of sync features by calling IFeature::Store, but it is generally recommended that only new symbols should be added.  ISymbolCollection2 provides new methods for adding new symbols to the collection and guaranteeing unique symbol IDs.  It is recommended that developers use ISymbolCollection2 to interact with the SymbolCollection.

See Also

ISymbolCollection2 Interface

.NET Related Topics

Creating annotation and dimension feature classes