ArcObjects Library Reference (Carto)  

IElementProperties Interface

Provides access to members that control the Element Properties. Note: the IElementProperties interface has been superseded byIElementProperties3. Please consider using the more recent version.

Product Availability

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

When To Use

IElementProperties is a generic interface implemented by all GraphicElement objects (TextElement, PolygonElement, LineElement, etc.). The interface is used to assign custom properties to an element.


Read/write property AutoTransform Indicates if transform is applied to symbols and other parts of element. False = only apply transform to geometry.
Read/write property CustomProperty Custom property.
Read/write property Name Name of the element.
Read/write property Type Type of the element.

CoClasses that implement IElementProperties

CoClasses and Classes Description
BmpPictureElement The Graphic Element to display BMP Pictures.
CircleElement The Graphic Element to display Circles.
DataGraphTElement (esriCartoUI) A container for the display and manipulation of data graph graphic element on the ArcMap layout view.
DisplacementLinkElement (esriEditorExt) The Graphic Element to display adjustment links.
EllipseElement The Graphic Element to display Ellipses.
EmfPictureElement The Graphic Element to display Emf Pictures.
FrameElement The Frame element to provide a neatline or background.
GeoEllipseElement (esriDefenseSolutions) The graphic element to display GeoEllipses.
GeoPolygonElement (esriDefenseSolutions) The graphic element for displaying GeoPolygons.
GeoPolylineElement (esriDefenseSolutions) The graphic element for displaying GeoPolylines.
GifPictureElement Graphic Element to display GIF Pictures.
GroupElement The Group Graphic Element to display a group of graphic elements.
IdentityLinkElement (esriEditorExt) The Graphic Element to display identity links.
InkGraphic Ink Graphic Object.
Jp2PictureElement Graphic Element to display JPEG2000 Pictures.
JpgPictureElement Graphic Element to display JPG Pictures.
LineElement The Graphic Element to display lines.
MapFrame A graphic element for displaying maps.
MapSurroundFrame A graphic element for displaying map surrounds.
MarkerElement The Graphic Element to display markers.
MultiPatchElement The MultiPatch Graphics Element CoClass.
OleFrame (esriArcMapUI) The OLE frame.
ParagraphTextElement The Graphic Element to display text which flows into an area geometry.
PictureElement Picture Graphic Element.
PMFTitleTextElement The Graphic Element to display dynamic PMF titles.
PngPictureElement Graphic Element to display PNG Pictures.
PolygonElement The Graphic Element to display polygons.
RectangleElement The Graphic Element to display rectangles.
TableFrame (esriEditorExt) Graphic Element to display table.
TemporalChartElement (esriTrackingAnalystUI) Controls elements of the temporal charts.
Text3DElement The Text3D Graphics Element CoClass.
TextElement The Graphic Element to display text.
TifPictureElement Graphic Element to display TIF Pictures.


Use the IElementProperties interface when you need to tag your graphic elements so that you can identify them later. An example of where this would be useful is when you add graphics to a layout, and know that you would want to delete them later, and need to distinguish them from the ones already present in the layout.

If you want to tag your element with a text string, you can simply use the Name or the Type property. If you want to associate another datatype with it, you can use the CustomProperty property which takes a Variant.

See Also

IElement Interface

.NET Samples

Geoevents in a MapControl (Code Files: GeoEvents) | Move a graphic along a path in ArcMap (Code Files: AnimationTypeMapGraphic MapGraphicKeyframe MapGraphicTrackExtension) | Copy the PageLayoutControl focus map and overwrite the MapControl map (Code Files: CopyFocusMap)