ArcGIS Pro 3.3 API Reference Guide
ArcGIS.Desktop.Layouts Namespace / Layout Class / SendBackward Method / SendBackward(IEnumerable<Element>) Method
The elements to send backward
Example

In This Topic
    SendBackward(IEnumerable<Element>) Method
    In This Topic
    Send the elements backward within their parent's element collection. This method must be called on the MCT. Use QueuedTask.Run.
    Syntax
    public void SendBackward( 
       IEnumerable<Element> elements
    )
    Public Overloads Sub SendBackward( _
       ByVal elements As IEnumerable(Of Element) _
    ) 

    Parameters

    elements
    The elements to send backward
    Exceptions
    ExceptionDescription
    This method or property must be called within the lambda passed to QueuedTask.Run.
    elements cannot be null or empty
    elements must belong to layout 'URI'
    element parents must be the same and non-null
    Remarks
    Refer to CanSendBackward(IEnumerable<Element>) to check whether the elements can be sent backward. Element z order can only be changed relative to their parent's element collection. All elements must have the same parent. The bottom element will have a z order of 0 within the element parent's element collection. Check individual element 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