ShapeCollection.Remove-Methode

Artikel
05/16/2015

Entfernt das angegebene 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 folgenden Formen in einer Position in der Auflistung verschoben.

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

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

Hinweise zur Vererbung

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

Beispiele

Das folgende Beispiel zeigt, wie die Remove-Methode verwendet, um Shape auf einem Formular zu entfernen, wenn es Mitglied ShapeCollection des Formulars. Dieses Beispiel erfordert, dass sich mindestens zwei OvalShape-Steuerelementen auf einem Formular befinden.

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.