ShapeCollection.Remove-Methode

Entfernt den angegebenen Shape aus der ShapeCollection.

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

Syntax

'Declaration
Public Sub Remove ( _
    value As Shape _
)

public void Remove(
    Shape value
)

public:
void Remove(
    Shape^ value
)

member Remove : 
        value:Shape -> unit

public function Remove(
    value : Shape
)

Parameter

value
Typ: Microsoft.VisualBasic.PowerPacks.Shape
Der Shape, der aus der ShapeCollection entfernt werden soll.

Hinweise

Wenn Shape aus der Steuerelementauflistung entfernt wird, werden alle nachfolgenden Forms an eine Position in der Auflistung verschoben.

Sie können auch Shape entfernen, indem Sie die RemoveAt-Methode verwenden, oder entfernen Sie alle Formen, indem Sie die Clear-Methode verwenden.

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

Hinweise zur Vererbung

Wenn Sie Remove in einer abgeleiteten Klasse überschreiben, müssen Sie unbedingt die Remove-Methode der Basisklasse aufrufen, um sicherzustellen, dass die Form aus der Auflistung entfernt wird.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die Remove-Methode verwendet, um Shape aus einem Formular zu entfernen, wenn es ein Member ShapeCollectiondes Formulars darstellt.Dieses Beispiel setzt voraus, dass Sie mindestens zwei OvalShape-Steuerelementen auf einem Formular verfügen.

Private Sub Form1_Click() Handles Me.Click
    Dim canvas As ShapeContainer
    ' Get the ShapeContainer.
    canvas = OvalShape1.Parent
    ' If OvalShape2 is in the same collection, remove it.
    If canvas.Shapes.Contains(OvalShape2) Then
        canvas.Shapes.Remove(OvalShape2)
    End If
End Sub

private void form1_Click(object sender, System.EventArgs e)
{
    ShapeContainer canvas;
    // Get the ShapeContainer.
    canvas = ovalShape1.Parent;
    // If OvalShape2 is in the same collection, remove it.
    if (canvas.Shapes.Contains(ovalShape2))
    {
        canvas.Shapes.Remove(ovalShape2);
    }
}

.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.