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


IElement Interface (ArcObjects .NET 10.5 SDK)
ArcObjects Library Reference (Carto)  

IElement Interface

Provides access to members that control the Element.

Product Availability

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

Members

Description
Method Activate Prepare to display graphic on screen.
Method Deactivate ActiveView that graphics are displayed on is no longer visible.
Method Draw Draws the element into the given display object.
Read/write property Geometry Shape of the element as a geometry.
Method HitTest Indicates if the given x and y coordinates are contained by the element.
Read/write property Locked Indicates if the element is in a read-only state.
Method QueryBounds Bounds of the element taking symbology into consideration.
Method QueryOutline Bounds of the element taking symbology into consideration.
Read-only property SelectionTracker Selection tracker used by this element.

CoClasses that implement IElement

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.
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.

Remarks

IElement is the generic interface implemented by all Element objects (TextElement, PolygonElement, LineElement, MapSurroundFrame, etc). The interface provides access to the geometry of the element and contains methods for drawing and performing hit tests.
An IElement object gnerally obtained and manipulated by IGraphicsContainer and IGraphicsContainerSelect objects. IElement is most often used when the developer wants to manipulate the selected set of graphics.

The geometry type of objects implementing IElement varies widely depending on what the element does.  The remarks of each object implementing IElement will list the geometry types that are valid for that specific element.

See Also

IGraphicsContainer Interface | IGraphicsContainerSelect Interface

.NET Snippets

Add Graphic to Map | Add Scale Bar | Add North Arrow | Add Legend | Create Graphic Buffers around Selected Features | Add Graphics Layer to Globe

.NET Samples

3D multipatch examples (Code Files: ElementUtilities) | Use a PageLayoutControl as an overview window (Code Files: Overview) | 3D dynamic element tracking (Code Files: TrackDynamicObject) | Visualizing the camera path while animating (Code Files: VisualizeCameraPath) | Display feedback (Code Files: DisplayFeedbackSampleVB) | Custom UI elements using add-ins (Code Files: AddGraphicsTool) | Extent view (Code Files: clsExtentView) | Brushing to create a selection (Code Files: BrushingVB) | Control text symbols using the SymbologyControl (Code Files: TextSymbols) | Geoevents in a MapControl (Code Files: GeoEvents) | Committing ink sketches using the controls ink commands (Code Files: InkSketchCommit) | Move a graphic along a path in ArcMap (Code Files: AnimationTypeMapGraphic cmdMoveGraphicAlongPath frmCreateGraphicTrackOptions MapGraphicKeyframe MapGraphicTrackExtension) | Copy the PageLayoutControl focus map and overwrite the MapControl map (Code Files: CopyFocusMap) | Creating a toolbar of globe tools (Code Files: Layer PointElement PolygonElement PolylineElement StyleElement TextElement) | Print multiple pages (Code Files: PrintMultiPagesVB_NET_Addin) | Custom scene navigation commands (Code Files: SelectGraphics) | Building a MapViewer application using the ArcGIS Engine controls (Code Files: AddDateTool) | Subset network evaluators (Code Files: AutoUpdateNetworkElementArrayParametersCommand SubsetHelperUI) | StreetMap routing (Code Files: RoutingForm) | Triangle graphic element (Code Files: TriangleElementClass TriangleElementTool) | Create a custom tool (Code Files: DrawGraphicLine) | Add map surrounds using the SymbologyControl (Code Files: NorthArrows ScaleBars ScaleText) | Update a legend format with SymbologyControl area and line patches (Code Files: AreaLinePatches) | Configure a command for a specific locale (Code Files: CultureTool)

.NET Related Topics

Adjusting feature locations with spatial adjustment | Building a map viewing application using the ArcGIS Engine controls | Create a custom tool | How to set output image quality | Implementing persistence | Selection trackers | Working with map elements | Working with map surrounds | Working with PageLayout elements