Método ShapeCollection.Clear

Artigo
10/26/2012

Remove todas as formas da coleção.

Namespace: Microsoft.VisualBasic.PowerPacks
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (em Microsoft.VisualBasic.PowerPacks.Vs.dll)

Sintaxe

'Declaração
Public Sub Clear

public void Clear()

public:
virtual void Clear() sealed

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

public final function Clear()

Implementações

IList.Clear()

Comentários

Você pode usar o Clear método para remover o conjunto inteiro de formas de um ShapeContainer.

Para remover uma forma individual da coleção, use o Remove ou RemoveAt método.

Para adicionar novos Shape objetos à coleção, use o Add ou AddRange método.

Observações para herdeiros

Ao substituir Clear em uma classe derivada, certifique-se de chamar o Clear método da classe base para garantir que todas as formas sejam removidas da coleção.

Exemplos

O exemplo a seguir demonstra como usar o Clear método para remover o conjunto inteiro de formas de um recipiente pai.Este exemplo requer que você tenha pelo menos duas OvalShape controles em um formulário.

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

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.