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

C#
Visual Basic (Declaration)

public void BringForward( 
   Element element
)

Public Overloads Sub BringForward( _
   ByVal element As Element _
)

Parameters

element: The element to bring forward

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: element
System.ArgumentException	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, Windows 8.1

Reference

Layout Class
Layout Members
Overload List

Send feedback