ArcObjects Library Reference (Carto)  

TextElement CoClass

The Graphic Element to display text.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Interfaces

Interfaces Description
IBoundsProperties Provides access to members that control Bounds Properties.
IClone (esriSystem) Provides access to members that control cloning of objects.
IElement Provides access to members that control the Element.
IElementEditCallout Provides access to members that control the Element edit vertices object.
IElementEditVertices Provides access to members that control the Element edit vertices object.
IElementProperties Provides access to members that control the Element Properties.
IElementProperties2 Provides access to members that control More Element Properties.
IElementProperties3 Provides access to members that control More Element Properties.
IGraphicElement Provides access to members that control the Graphic Element object.
IGroupSymbolElement Provides access to members that control Group Symbol Elements.
IMultiPartTextElement Provides access to methods and properties for maintaining multipart elements.
IPersistStream (esriSystem)
IPropertySupport (esriSystem) Provides access to members that set a default property on an object.
ISymbolCollectionElement Provides further access to members that control Collection Symbol Elements.
ITextElement Provides access to members that control the Text element.
ITransform2D (esriGeometry) Provides access to methods for transforming geometries using either specific parameters or arbitrary transformation objects (affine transformations, geographic transformations, etc.).
IXMLSerialize (esriSystem) Provides access to members that XML serialize and deserialize an object to/from XML.

Remarks

The TextElement object has many roles from the title of a map layout to a piece of feature-linked annotation and everything in between.  Every piece of text or annotation on a map or layout is a TextElement, with the exception of paragraph text which is a ParagraphTextElement .  The primary interface for the TextElement object is ITextElement, but like most elements, the object is usually passed using an IElement interface pointer.

Use this object when you want to place text on a map, layout, or in an annotation feature class.

Geometry: TextElement accepts geometry of type esriGeometryPoint, esriGeometryPolyline, or esriGeometryBag.  For drawing text in a polygon or envelope, use a ParagraphTextElement.  TextElement's with a Polyline or GeometryBag geometry type will have an associated text path type.  Specifically, GeometryBag geomtries are used with a WordTextPath to draw multipart text.  The GeometryBag may consist of points, lines, or multipoints.  Multipoint geometries in this cases correspond to the multipart equivalent of an OverposterTextPath where each glyph in the text string has a defined position.

See Also

IElement Interface | IGraphicElement Interface