ShapeCollection.Clear (Método)

Artículo
09/04/2008

Actualización: noviembre 2007

Quita todas las formas de la colección.

Espacio de nombres: Microsoft.VisualBasic.PowerPacks
Ensamblado: Microsoft.VisualBasic.PowerPacks.Vs (en Microsoft.VisualBasic.PowerPacks.Vs.dll)

Sintaxis

Public Sub Clear

Dim instance As ShapeCollection

instance.Clear()

public void Clear()

public:
virtual void Clear() sealed

public final function Clear()

Implementaciones

IList.Clear()

Comentarios

Puede utilizar el método Clear para quitar toda la colección de formas de ShapeContainer.

Para quitar una forma individual de la colección, utilice el método Remove o RemoveAt.

Para agregar objetos Shape nuevos a la colección, utilice el método Add o AddRange.

Notas para los herederos:

Al invalidar el método Clear en una clase derivada, asegúrese de llamar al método Clear de la clase base para garantizar que se quitan todas las formas de la colección.

Ejemplos

En el ejemplo siguiente se muestra cómo utilizar el método Clear para quitar toda la colección de formas de un contenedor primario. Este ejemplo requiere que tenga al menos dos controles OvalShape en un formulario.

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

Permisos

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.