Shape.BringToFront-Methode

Artikel
08/23/2008

Aktualisiert: November 2007

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

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

Syntax

Public Sub BringToFront

Dim instance As Shape

instance.BringToFront()

public void BringToFront()

public:
void BringToFront()

public function BringToFront()

Hinweise

Mit der BringToFront-Methode können Sie das Steuerelement LineShape, OvalShape oder RectangleShape im Vordergrund 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 BringToFront-Methode die Z-Reihenfolge von Formen zur Laufzeit ändern. Für dieses Beispiel müssen Sie über ein RectangleShape-Steuerelement mit dem Namen RectangleShape1 und über ein OvalShape-Steuerelement mit dem Namen OvalShape1 auf einem Formular verfügen. 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
    ' Bring the control that was clicked to the top of the z-order.
    sender.BringToFront()
End Sub

private void Shapes_Click(System.Object sender, System.EventArgs e)
{
    // Bring the control that was clicked to the top of the z-order.
    ((Shape)sender).BringToFront();
}

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.