Metodo ShapeCollection.Remove

Articolo
10/30/2012

rimuove specificato Shape da ShapeCollection.

Spazio dei nomi: Microsoft.VisualBasic.PowerPacks
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)

Sintassi

'Dichiarazione
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
)

Parametri

value
Tipo: Microsoft.VisualBasic.PowerPacks.Shape
Shape per rimuovere dal ShapeCollection.

Note

quando a Shape viene rimosso dalla raccolta del controllo, tutte le forme successive vengono promossi una posizione nella raccolta.

È anche possibile rimuovere un oggetto Shape tramite RemoveAt il metodo, o rimuove tutte le forme utilizzando Clear metodo.

Per aggiungere un nuovo Shape gli oggetti alla raccolta, utilizzano Add o AddRange metodo.

Note per gli eredi

Quando si sottopone a override Remove in una classe derivata, assicurarsi di chiamare Remove metodo della classe base per garantire che la forma verrà rimosso dalla raccolta.

Esempi

Nell'esempio seguente viene illustrato come utilizzare Remove metodo per rimuovere a Shape da un form se è un membro del form ShapeCollection.Questo esempio richiede la presenza di almeno due OvalShape controlli in un form.

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);
    }
}

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.