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

• Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

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)