Metodo ShapeCollection.Clear

Articolo
09/12/2008

Aggiornamento: novembre 2007

Rimuove tutte le forme dall'insieme.

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

Sintassi

Public Sub Clear

Dim instance As ShapeCollection

instance.Clear()

public void Clear()

public:
virtual void Clear() sealed

public final function Clear()

Implementa

IList.Clear()

Note

È possibile utilizzare il metodo Clear per rimuovere l'intero insieme di forme da un oggetto ShapeContainer.

Per rimuovere una singola forma dall'insieme, utilizzare il metodo Remove o RemoveAt.

Per aggiungere nuovi oggetti Shape all'insieme, utilizzare il metodo Add o AddRange.

Note per gli eredi:

Quando si esegue l'override di Clear in una classe derivata, assicurarsi di chiamare il metodo Clear della classe base per garantire che tutte le forme vengano rimosse dall'insieme.

Esempi

Nell'esempio riportato di seguito viene illustrato come utilizzare il metodo Clear per rimuovere l'intero insieme di forme da un contenitore padre. Per questo esempio è necessario disporre in un form di almeno due controlli OvalShape.

  Private Sub Form1_Click(ByVal sender As Object, _
ByVal e As System.EventArgs) 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();
}

Autorizzazioni

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.