ShapeCollection.Clear-Methode

Entfernt alle Formen aus der Auflistung.

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

Syntax

'Declaration
Public Sub Clear

public void Clear()

public:
virtual void Clear() sealed

abstract Clear : unit -> unit 
override Clear : unit -> unit

public final function Clear()

Implementiert

IList.Clear()

Hinweise

Sie können die Clear-Methode verwenden, um die gesamte Auflistung von Formen von ShapeContainerzu entfernen.

Um eine einzige Form des aus der Auflistung zu entfernen, verwenden Sie die Remove oder RemoveAt-Methode.

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

Hinweise zur Vererbung

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

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die Clear-Methode verwendet, um die gesamte Auflistung von Formen von einem übergeordneten Container zu entfernen.Dieses Beispiel setzt voraus, dass Sie mindestens zwei OvalShape-Steuerelementen auf einem Formular verfügen.

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

.NET Framework-Sicherheit

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.