ShapeCollection.Clear-Methode

Artikel
08/23/2008

Aktualisiert: November 2007

Entfernt alle Formen aus der Auflistung.

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

Syntax

Public Sub Clear

Dim instance As ShapeCollection

instance.Clear()

public void Clear()

public:
virtual void Clear() sealed

public final function Clear()

Implementiert

IList.Clear()

Hinweise

Mit der Clear-Methode können Sie die gesamte Formenauflistung aus dem ShapeContainer-Objekt entfernen.

Wenn Sie eine einzelne Form aus der Auflistung entfernen möchten, verwenden Sie die Remove-Methode oder die RemoveAt-Methode.

Um der Auflistung neue Shape-Objekte hinzuzufügen, verwenden Sie die Add-Methode oder die AddRange-Methode.

Hinweise zur Vererbung:

Wenn Sie Clear in einer abgeleiteten Klasse überschreiben, müssen Sie die Clear-Methode der Basisklasse aufrufen, um sicherzustellen, dass alle Formen aus der Auflistung entfernt werden.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie mit der Clear-Methode die gesamte Formenauflistung aus einem übergeordneten Container entfernen. Für dieses Beispiel sind mindestens zwei OvalShape-Steuerelemente auf einem Formular erforderlich.

  Private Sub Form1_Click(ByVal sender As Object, _
ByVal e As System.EventArgs) Handles Me.Click
      ' Call the method to remove the shapes.
      RemoveShapes(OvalShape1)
  End Sub

  Private Sub RemoveShapes(ByVal shape As Shape)
      Dim canvas As ShapeContainer

      ' Find the ShapeContainer in which the shape is located.
      canvas = shape.Parent
      ' Call the Clear method to remove all shapes.
      canvas.Shapes.Clear()
  End Sub

private void form1_Click(object sender, System.EventArgs e)
{
    // Call the method to remove the shapes.
    RemoveShapes(ovalShape1);
}

private void RemoveShapes(Shape shape)
{
    ShapeContainer canvas;

    // Find the ShapeContainer in which the shape is located.
    canvas = shape.Parent;
    // Call the Clear method to remove all shapes.
    canvas.Shapes.Clear();
}

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.