UnGroupElements Method (GraphicsLayerExtensions)

In This Topic

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

Syntax

C#
Visual Basic (Declaration)

public static void UnGroupElements( 
   GraphicsLayer graphicsLayer,
   IEnumerable<GroupElement> groups
)

Public Shared Sub UnGroupElements( _
   ByVal graphicsLayer As GraphicsLayer, _
   ByVal groups As IEnumerable(Of GroupElement) _
)

Parameters

graphicsLayer
groups: The group elements whose elements are to be ungrouped

Exceptions

Exception	Description
ArcGIS.Core.CalledOnWrongThreadException	This method or property must be called within the lambda passed to QueuedTask.Run.
System.ArgumentException	groups cannot be null or empty
System.ArgumentException	elements must belong to graphicsLayer
System.ArgumentException	element parents must be the same and non-null

Remarks

All group elements in the input collection must have the same parent.

Example

Un-Group Graphic Elements

var selectedElements = graphicsLayer.GetSelectedElements().ToList(); ;
if (selectedElements?.Any() == false)//must be at least 1.
  return;
var elementsToUnGroup = new List<GroupElement>();
//All selected elements should be grouped.
if (selectedElements.Count() == selectedElements.OfType<GroupElement>().Count())
{
  //Convert to a GroupElement list.
  elementsToUnGroup = selectedElements.ConvertAll(x => (GroupElement)x);
}
if (elementsToUnGroup.Count() == 0)
  return;
//UnGroup
graphicsLayer.UnGroupElements(elementsToUnGroup);

Requirements

Target Platforms: Windows 11, Windows 10, Windows 8.1

Reference

GraphicsLayerExtensions Class
GraphicsLayerExtensions Members

Send feedback