ShapeCollection.RemoveAt-Methode

Artikel
10/24/2012

Entfernt Shape von ShapeCollection an der angegebenen indizierten Position.

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: System.Int32
Der Indexwert des zu entfernenden Shape.

Implementiert

IList.RemoveAt(Int32)

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

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die RemoveAt-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 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.