Metodo ShapeCollection.Clear

Articolo
10/30/2012

Rimuove tutte le forme dalla raccolta.

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

Sintassi

'Dichiarazione
Public Sub Clear

public void Clear()

public:
virtual void Clear() sealed

abstract Clear : unit -> unit 
override Clear : unit -> unit

public final function Clear()

Implementa

IList.Clear()

Note

È possibile utilizzare Clear metodo per rimuovere l'intera libreria di forme da un oggetto ShapeContainer.

Per rimuovere una singola forma dalla raccolta, utilizzare Remove o RemoveAt metodo.

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

Note per gli eredi

Quando si sottopone a override Clear in una classe derivata, assicurarsi di chiamare Clear metodo della classe base per garantire che tutte le forme vengono rimosse dalla raccolta.

Esempi

Nell'esempio seguente viene illustrato come utilizzare Clear metodo per rimuovere l'intera libreria di forme da un contenitore padre.Questo esempio richiede la presenza di almeno due OvalShape controlli in un form.

Private Sub Form1_Click() Handles Me.Click
    ' Call the method to remove the shapes.
    RemoveShapes(OvalShape1)
End Sub

Private Sub RemoveShapes(ByVal shape As Shape)
    Dim canvas As ShapeContainer

    ' Find the ShapeContainer in which the shape is located.
    canvas = shape.Parent
    ' Call the Clear method to remove all shapes.
    canvas.Shapes.Clear()
End Sub

private void form1_Click(object sender, System.EventArgs e)
{
    // Call the method to remove the shapes.
    RemoveShapes(ovalShape1);
}

private void RemoveShapes(Shape shape)
{
    ShapeContainer canvas;

    // Find the ShapeContainer in which the shape is located.
    canvas = shape.Parent;
    // Call the Clear method to remove all shapes.
    canvas.Shapes.Clear();
}

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.