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

public void SendToBack()

public:
void SendToBack()

member SendToBack : unit -> unit

Public Sub 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 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();
}

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

See Also

Shape Class
Microsoft.VisualBasic.PowerPacks Namespace
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)

Return to top