ArcGIS Pro 3.3 API Reference Guide
ArcGIS.Desktop.Layouts Namespace / Layout Class / BringForward Method / BringForward(Element) Method
The element to bring forward
Example

In This Topic
    BringForward(Element) Method
    In This Topic
    Bring the element forward within its parent's element collection. This method must be called on the MCT. Use QueuedTask.Run.
    Syntax
    public void BringForward( 
       Element element
    )
    Public Overloads Sub BringForward( _
       ByVal element As Element _
    ) 

    Parameters

    element
    The element to bring forward
    Exceptions
    ExceptionDescription
    This method or property must be called within the lambda passed to QueuedTask.Run.
    Value cannot be null: element
    elements must belong to layout 'URI'
    Remarks
    Refer to CanBringForward(Element) to check whether an element can be brought forward.Element z order can only be changed relative to its parent's element collection. The top element will have a z order of N - 1 where N is equal to the number of elements within the element parent's element collection. Check z order with Element.ZOrder.
    Example
    Ordering: Send backward and Bring forward
    //On the QueuedTask
    //get the current selection set
    var sel_elems = layout.GetSelectedElements();
    //can they be brought forward? This will also check that all elements have the same parent
    if (layout.CanBringForward(sel_elems))
    {
      //bring forward
      layout.BringForward(sel_elems);
      //bring to front (of parent)
      //graphicsLayer.BringToFront(sel_elems);
    }
    else if (layout.CanSendBackward(sel_elems))
    {
      //send back
      layout.SendBackward(sel_elems);
      //send to the back (of parent)
      //graphicsLayer.SendToBack(sel_elems);
    }
    Requirements

    Target Platforms: Windows 11, Windows 10

    ArcGIS Pro version: 3 or higher.
    See Also