CreateGroupElement(ILayoutElementContainer) Method

Creates an empty group element at the root level of the element container. This method must be called on the MCT. Use QueuedTask.Run.

Syntax

C#
Visual Basic (Declaration)

GroupElement CreateGroupElement( 
   ILayoutElementContainer elementContainer
)

Overloads Function CreateGroupElement( _
   ByVal elementContainer As ILayoutElementContainer _
) As GroupElement

Parameters

elementContainer: Layout or GroupElement

Return Value

Returns a GroupElement.

Exceptions

Exception	Description
ArcGIS.Core.CalledOnWrongThreadException	This method or property must be called within the lambda passed to QueuedTask.Run.

Remarks

If the element container is a Layout then the element gets added to the root level of the layout TOC at the top most position. If the element container is a GroupElement then it gets added to the group at the top most position.

Example

//Create an empty group element at the root level of the contents pane.


//Construct on the worker thread
await QueuedTask.Run(() =>
{
  GroupElement emptyGroupAtRoot = LayoutElementFactory.Instance.CreateGroupElement(layout);
  emptyGroupAtRoot.SetName("Empty group at root");
});

//Create an empty group element at the root level of another group element.

//Find an existing group element
GroupElement existingGroupAtRoot = layout.FindElement("Empty group at root") as GroupElement;

//Construct on the worker thread
await QueuedTask.Run(() =>
{
  GroupElement emptyGroupInGroupAtRoot = LayoutElementFactory.Instance.CreateGroupElement(existingGroupAtRoot);
  emptyGroupInGroupAtRoot.SetName("Empty group in group at root");
});

Requirements

Target Platforms: Windows 11, Windows 10, Windows 8.1

Reference

IElementFactory Interface
IElementFactory Members
Overload List