CopyElements(GraphicsLayer,GroupElement,IEnumerable<Element>) Method

In This Topic

Copy the elements into a group element within the graphics layer. This method must be called on the MCT. Use QueuedTask.Run.

Syntax

C#
Visual Basic (Declaration)

public static IReadOnlyList<Element> CopyElements( 
   GraphicsLayer graphicsLayer,
   GroupElement group,
   IEnumerable<Element> elements
)

Public Overloads Shared Function CopyElements( _
   ByVal graphicsLayer As GraphicsLayer, _
   ByVal group As GroupElement, _
   ByVal elements As IEnumerable(Of Element) _
) As IReadOnlyList(Of Element)

Parameters

graphicsLayer
group: A group element within the graphics layer
elements: The elements to be copied

Return Value

IReadOnlyList

Exceptions

Exception	Description
ArcGIS.Core.CalledOnWrongThreadException	This method or property must be called within the lambda passed to QueuedTask.Run.
System.ArgumentException	elements must belong to a graphics layer
System.InvalidOperationException	Map has reached maximum graphics count limit of 4000 elements. One or more elements cannot be created.
System.InvalidOperationException	Map has reached maximum graphics size limit of 10 MB. One or more elements cannot be created.

Remarks

The group element must belong to the graphics layer into which the elements are being copied. Only elements from a single graphics layer can be copied at one time. To copy elements from multiple graphics layers CopyElements must be called each time.
If a group element is provided in the list of elements to be copied then the group element and all its children will be copied.
If a child of a group element is provided in the list in addition to its parent then the parent takes precedence (i.e. the entire group element is copied and not just that child).
If a child element of a group element is provided in the list but its parent is not then only the child element is copied. The parent of the copied element will be the target group element.
The map view displaying the graphics layers should be initialized.

Example

Copy Graphic elements

//on the QueuedTask
var elems = sourceGraphicsLayer.FindElements(new List<string>() { "Point 1", "Line 3", "Text 1" });
var copiedElements = targetGraphicsLayer.CopyElements(elems);

Requirements

Target Platforms: Windows 11, Windows 10

ArcGIS Pro version: 3 or higher.

Reference

GraphicsLayerExtensions Class
GraphicsLayerExtensions Members
Overload List

Send feedback