 |
This document is archived and information here might be outdated. Recommended version. |
TextElement Class (ArcObjects .NET 10.8 SDK)
|
This document is archived and information here might be outdated. Recommended version. |
The Graphic Element to display text.
| 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. |
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.