Share via


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)

Syntax

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

Remarks

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.

Examples

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.
    sender.SendToBack()
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.
    ((Shape)sender).SendToBack();
}

.NET Framework Security

See Also

Reference

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)