ShapeCollection.RemoveAt-Methode

Artikel
05/16/2015

Entfernt eine Shape am angegebenen Speicherort des Index aus der ShapeCollection.

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

Syntax

'Declaration
Public Sub RemoveAt ( _
    index As Integer _
)

public void RemoveAt(
    int index
)

public:
virtual void RemoveAt(
    int index
) sealed

abstract RemoveAt : 
        index:int -> unit  
override RemoveAt : 
        index:int -> unit

public final function RemoveAt(
    index : int
)

Parameter

index
Typ: Int32

Der Indexwert des zu entfernenden Shape.

Implementiert

IList.RemoveAt(Int32)

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 Remove-Methode, alle Formen, indem Sie die Clear-Methode.

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

Beispiele

Das folgende Beispiel zeigt, wie die RemoveAt-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 OvalShape2_Click() Handles OvalShape2.Click
    Dim i As Integer 
    ' Find the index for OvalShape1.
    i = OvalShape2.Parent.Shapes.GetChildIndex(OvalShape1, False)
    ' If the shape is not in the collection, display a message. 
    If i = -1 Then
        MsgBox("OvalShape1 is not in this collection.")
    Else 
        ' Remove the shape.
        OvalShape2.Parent.Shapes.RemoveAt(i)
    End If 
End Sub

private void ovalShape2_Click(System.Object sender, System.EventArgs e)
{
    int i;
    // Find the index for OvalShape1.
    i = ovalShape2.Parent.Shapes.GetChildIndex(ovalShape1, false);
    // If the shape is not in the collection, display a message. 
    if (i == -1)
    {
        MessageBox.Show("ovalShape1 is not in this collection.");
    }
    else
    {
        // Remove the shape.
        ovalShape2.Parent.Shapes.RemoveAt(i);
    }
}

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