FindElement Method (GraphicsLayerExtensions)

In This Topic

Finds the element recursively with the given name within the GraphicsLayer collection. This method must be called on the MCT. Use QueuedTask.Run.

Syntax

Visual Basic (Declaration)
C#

Public Shared Function FindElement( _
   ByVal graphicsLayer As GraphicsLayer, _
   ByVal elementName As String _
) As Element

public static Element FindElement( 
   GraphicsLayer graphicsLayer,
   string elementName
)

Parameters

graphicsLayer: The graphics layer being extended
elementName: The name of the element to find. Cannot be null

Return Value

The ArcGIS.Desktop.Layouts.Element or null if it is not found

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: elementName

Remarks

Find recurses nested groups to find the given element.
The map view displaying the graphics layer should be initialized.

Example

Modify symbology of a Graphic Element

{
  // Note: must be called on the QueuedTask
  {
    //within a queued Task
    //get the first line element in the layer
    var ge = graphicsLayer.FindElement("Line 10") as GraphicElement;
    var graphic = ge.GetGraphic();
    if (graphic is CIMLineGraphic lineGraphic)
    {
      //change its symbol
      lineGraphic.Symbol =
       SymbolFactory.Instance.ConstructLineSymbol(
         SymbolFactory.Instance.ConstructStroke(
     ColorFactory.Instance.BlueRGB, 2, SimpleLineStyle.DashDot)).MakeSymbolReference();
      //apply the change
      ge.SetGraphic(lineGraphic);
    }
  }
}

Requirements

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

ArcGIS Pro version: 3.0 or higher.

Reference

GraphicsLayerExtensions Class
GraphicsLayerExtensions Members

Send feedback