ArcObjects Library Reference (Carto)  

GroupElement CoClass

The Group Graphic Element to display a group of graphic elements.

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.
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.
IFrameDraw Provides access to members that control frame drawing.
IFrameElement Provides access to members that control the Frame element object.
IFrameProperties Provides access to members that control the General properties for a frame.
IGraphicElement Provides access to members that control the Graphic Element object.
IGraphicsContainerProperty Provides access to members that control Graphics Container Properties.
IGroupElement Provides access to members that control the Group element.
IGroupElement2 Provides access to members that control the Group element.
IGroupElement3 Provides access to members that control the Group element.
IPersistStream (esriSystem)
IPropertySupport (esriSystem) Provides access to members that set a default property on an object.
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

As the name implies, a GroupElement object contains a set of elements that have been grouped together.  For instance, when working with a map layout it is common to group multiple elements (such as a data frame and the associated legend) together to facilitate the movement of these entities as a single element.

GroupElements can either be created, or they can be retrieved from an IGraphicsContainer reference.  For instance, IGraphicsContainer::Next will return an IElement pointer.  The developer can then check to see if the IElement also implements IGroupElement .  If it does, then IGroupElement can then be used to extract the individual elements.  Once obtained, GroupElements can be updated directly through the IGroupElement interface, or indirectly through the IGraphicsContainer interface.

Geometry: GroupElement accepts geometry of any type but works differently than other elements since it is composed of sub elements that have their own geometries.  When the geometry of a GroupElement is updated, the envelope of the new geometry is used to move the entire set of internal elements based on the difference between the envelope of the new geometry and the old geometry.