Metodo ShapeCollection.Remove

Articolo
05/16/2015

Rimuove l'oggetto Shape specificato dall'oggetto 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

Oggetto Shape da rimuovere da ShapeCollection.

Note

Quando Shape viene rimosso dalla raccolta del controllo, tutte le forme successive vengono alzate una posizione nella raccolta.

È anche possibile rimuovere Shape tramite il metodo di RemoveAt, rimuovere tutte le forme utilizzando il metodo di Clear.

Per aggiungere nuovi oggetti di Shape alla raccolta, utilizzare il metodo di AddRange o di Add.

Note per gli eredi

Nell'eseguire l'override di Remove in una classe derivata, assicurarsi di chiamare il metodo di Remove della classe base per garantire che la forma verrà rimosso dalla raccolta.

Esempi

Nell'esempio seguente viene illustrato come utilizzare il metodo Remove per rimuovere Shape da un form se è un membro di ShapeCollectiondel form. Questo esempio è necessario disporre di almeno due controlli di OvalShape 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 altre informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.