Shape.SendToBack Method

Sends a line or shape control to the back of the z-order.

Namespace:  Microsoft.VisualBasic.PowerPacks
Assembly:  Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)


Public Sub SendToBack
public void SendToBack()
void SendToBack()
member SendToBack : unit -> unit
public function SendToBack()


The SendToBack method can be used to position a LineShape, OvalShape or RectangleShape control behind of all other line and shape controls on a given container. It does not position the control in front of other types of controls on the container; graphics drawn with line and shape controls always appear behind the other controls.


The following example demonstrates how to use the SendToBack method to change the z-order of shapes at run time. This example requires that you have a RectangleShape control named RectangleShape1 and an OvalShape control Named OvalShape1 on a form. For best results, make the controls different colors and make sure that they overlap each other.

Private Sub Shapes_Click(
    ByVal sender As System.Object, 
    ByVal e As System.EventArgs
  ) Handles RectangleShape1.Click, OvalShape1.Click

    ' Send the control that was clicked to the bottom of the z-order.
End Sub
private void Shapes_Click(System.Object sender, System.EventArgs e)
    // Send the control that was clicked to the bottom of the z-order.

.NET Framework Security

See Also


Shape Class

Microsoft.VisualBasic.PowerPacks Namespace

Other Resources

How to: Draw Lines with the LineShape Control (Visual Studio)

How to: Draw Shapes with the OvalShape and RectangleShape Controls (Visual Studio)

Introduction to the Line and Shape Controls (Visual Studio)