Metodo ShapeCollection.Clear

Articolo
05/16/2015

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 il metodo di Clear per cancellare l'intera raccolta di forme da ShapeContainer.

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

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 Clear in una classe derivata, assicurarsi di chiamare il metodo di Clear della classe base per garantire che tutte le forme vengono rimosse dalla raccolta.

Esempi

Nell'esempio seguente viene illustrato come utilizzare il metodo Clear per cancellare l'intera raccolta di forme da un contenitore padre. Questo esempio è necessario disporre di almeno due controlli di OvalShape 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 altre informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.