UnGroupElement Method (Layout)

In This Topic

Ungroup the elements contained in 'group'. This method must be called on the MCT. Use QueuedTask.Run.

Syntax

Visual Basic (Declaration)
C#

Public Sub UnGroupElement( _
   ByVal group As GroupElement _
)

public void UnGroupElement( 
   GroupElement group
)

Parameters

group: The group element whose elements will be ungrouped

Exceptions

Exception	Description
ArcGIS.Core.CalledOnWrongThreadException	This method or property must be called within the lambda passed to QueuedTask.Run.
System.ArgumentNullException	Value cannot be null: group
System.ArgumentException	elements must belong to layout 'URI'

Example

Un-Group Graphic Elements

{
  //Note: Must be on QueuedTask.Run
  var selectedElements = layout.GetSelectedElements().ToList();
  if (selectedElements?.Count == 0)//must be at least 1.
    return;
  var elementsToUnGroup = new List<GroupElement>();
  //All selected elements should be grouped elements.
  if (selectedElements.Count() == selectedElements.OfType<GroupElement>().Count())
  {
    //Convert to a GroupElement list.
    elementsToUnGroup = selectedElements.ConvertAll(x => (GroupElement)x);
  }
  if (elementsToUnGroup.Count() == 0)
    return;
  //UnGroup many grouped elements
  layout.UnGroupElements(elementsToUnGroup);
  //Ungroup one grouped element
  layout.UnGroupElement(elementsToUnGroup.FirstOrDefault());
}

Requirements

Target Platforms: Windows 11 Home, Pro, Enterprise (64 bit)

ArcGIS Pro version: 3.0 or higher.

Reference

Layout Class
Layout Members

Send feedback