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


TextSymbol CoClass (ArcObjects .NET 10.5 SDK)
ArcObjects Library Reference (Display)  

TextSymbol CoClass

A symbol that controls how text is displayed.

Product Availability

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

Description

Use TextSymbol to create text of either IFormattedTextSymbol or ISimpleTextSymbol.

Supported Platforms

Windows, Solaris, Linux

Interfaces

Interfaces Description
ICharacterOrientation Provides access to characters orientation.
IClone (esriSystem) Provides access to members that control cloning of objects.
IDisplayName Provides access to members that return the display name of an object.
IFormattedTextSymbol Provides access to members that control the formatted text symbol.
IMapLevel Provides access to members that control the map level.
IMarginProperties Provides access to members that control uniform text margin properties.
IMask Provides access to members that control the symbol mask.
IPersist Defines the single method GetClassID, which is designed to supply the CLSID of an object that can be stored persistently in the system. IPersist is the base interface for three other interfaces: IPersistStorage, IPersistStream, and IPersistFile.
IPersistStream (esriSystem)
IPropertySupport (esriSystem) Provides access to members that set a default property on an object.
IQueryGeometry Provides access to members that control geometry query.
ISimpleTextSymbol Provides access to members that control the simple text symbol.
ISymbol Provides access to members that control symbols.
ISymbolRotation Provides access to the symbol rotation properties.
ITextDrawSupport Provides access to members that control how text strings are drawn.
ITextParserSupport Provides access to members that control the text parsing support.
ITextSymbol Provides access to members that control text symbols.
IWordBoundaries Provides access to word boundaries for a text symbol.
IXMLSerialize (esriSystem) Provides access to members that XML serialize and deserialize an object to/from XML.

Remarks

TextSymbol is the primary object for defining the display properties of a TextElement.  Commonly edited properties can be set using ITextSymbol while additional interfaces such as ISimpleTextSymbol and IFormattedTextSymbol provide access to other display properties.  Text properties such as highway shields and callouts are implemented as Text Backgrounds and can controlled using IFormattedTextSymbol:Background.  The Text property of TextSymbol is only used for low level drawing of text.  The text string should be set on the TextElement.


If you are editing Geodatabase Annotation, DO NOT control the display of annotation features by obtaining a reference to the TextSymbol through ITextElement::Symbol and change the properties.  This will undermine the storage mechanism that Geodatabase Annotation utilizes for efficient storage.  For more information on TextSymbols and Geodatabase Annotation, see the interface ISymbolCollectionElement.

See Also

ISimpleTextSymbol Interface | ITextSymbol Interface | IFormattedTextSymbol Interface