Shape.SendToBack-Methode

Artikel
08/23/2008

Aktualisiert: November 2007

Positioniert ein Line- oder Shape-Steuerelement am Ende der Z-Reihenfolge.

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

Syntax

Public Sub SendToBack

Dim instance As Shape

instance.SendToBack()

public void SendToBack()

public:
void SendToBack()

public function SendToBack()

Hinweise

Mit der SendToBack-Methode können Sie das Steuerelement LineShape, OvalShape oder RectangleShape im Hintergrund aller anderen Line- und Shape-Steuerelemente in einem bestimmten Container positionieren. Hierdurch wird das Steuerelement nicht vor anderen Steuerelementtypen in dem Container platziert. Grafiken, die mit Line- und Shape-Steuerelementen gezeichnet wurden, sind immer hinter den anderen Steuerelementen positioniert.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie mit der SendToBack-Methode die Z-Reihenfolge von Formen zur Laufzeit ändern. Für dieses Beispiel sind ein RectangleShape-Steuerelement mit dem Namen RectangleShape1 und ein OvalShape-Steuerelement mit dem Namen OvalShape1 auf einem Formular erforderlich. Weisen Sie den Steuerelementen unterschiedliche Farben zu, und stellen Sie sicher, dass sie einander überlappen, um ein optimales Ergebnis zu erzielen.

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

Berechtigungen

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.