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.