The Group Graphic Element to display a group of graphic elements.
Product Availability
Supported Platforms
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.