Método ShapeCollection.Clear

Artigo
08/25/2010

Remove todas as formas da coleção.

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

Sintaxe

Public Sub Clear

Dim instance As ShapeCollection

instance.Clear()

public void Clear()

public:
virtual void Clear() sealed

public final function Clear()

Implementações

IList.Clear()

Comentários

Você pode usar o Clear método para remover da coleção inteira de formas de um ShapeContainer.

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

Para adicionar novo Shape os objetos à coleção, usam o Add ou AddRange método.

Observações para Inheritors:

Ao substituir Clear uma classe derivada, certifique-se de telefonar 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 toda a coleção de formas de um contêiner pai. Este exemplo requer que você tenha pelo menos dois OvalShape controles em um formulário.

PrivateSub Form1_Click(ByVal sender AsObject, _
ByVal e As System.EventArgs) HandlesMe.Click
      ' Call the method to remove the shapes.
      RemoveShapes(OvalShape1)
  EndSubPrivateSub 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()
  EndSub

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

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

Permissões

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ódigos parcialmente Confiável.