ShapeCollection.Clear (Método)

Artículo
05/17/2015

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

'Declaración
Public Sub Clear

public void Clear()

public:
virtual void Clear() sealed

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

public final function Clear()

Implementaciones

IList.Clear

Comentarios

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

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

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

Notas para los herederos

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

Ejemplos

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

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

Seguridad de .NET Framework

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.