ArcGIS Pro 3.7 API Reference Guide
ArcGIS.Desktop.Mapping Namespace / IElementContainer Interface / FindElement Method
The element name.
(optional) When true the search continues in group elements. (default value = true)
Example

In This Topic
    FindElement Method (IElementContainer)
    In This Topic
    Finds the element specified by name.
    Syntax
    Function FindElement( _
       ByVal elementName As String, _
       Optional ByVal recurse As Boolean _
    ) As IElement

    Parameters

    elementName
    The element name.
    recurse
    (optional) When true the search continues in group elements. (default value = true)

    Return Value

    The element
    Example
    Create a group element with elements
    {
      //Create a group with a list of elements at the root level of the contents pane.
    
      //Find an existing elements
      //container is IElementContainer - GroupLayer or Layout
      var elem1 = layout.FindElement("Polygon 1");
      var elem2 = layout.FindElement("Bezier Text");
      var elem3 = layout.FindElement("Cloud Shape 2");
    
      //Construct a list and add the elements
      var elmList = new List<Element>
      {
        elem1,
        elem2,
        elem3
      };
      //Note: Must be on QueuedTask.Run
    
      GroupElement groupWithListOfElementsAtRoot =
                ElementFactory.Instance.CreateGroupElement(
                         layout, elmList, "Group with list of elements at root");
      // *** or ***
    
      //Create a group using a list of element names at the root level of the contents pane.
    
      //List of element names
      var elmNameList = new[] { "Para Text1", "Line 3" };
    
      //Note: Must be on QueuedTask.Run
    
      var elemToGroup = layout.FindElements(elmNameList);
      GroupElement groupWithListOfElementNamesAtRoot =
            ElementFactory.Instance.CreateGroupElement(
                 layout, elemToGroup, "Group with list of element names at root");
    }
    Requirements

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

    ArcGIS Pro version: 3.0 or higher.
    See Also