ShapeCollection.Remove (Método)

Artículo
05/17/2015

Quita el Shape especificado de ShapeCollection.

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

Sintaxis

'Declaración
Public Sub Remove ( _
    value As Shape _
)

public void Remove(
    Shape value
)

public:
void Remove(
    Shape^ value
)

member Remove : 
        value:Shape -> unit

public function Remove(
    value : Shape
)

Parámetros

value
Tipo: Microsoft.VisualBasic.PowerPacks.Shape

Shape que se va a quitar de ShapeCollection.

Comentarios

Cuando Shape se quita de la colección del control, todas las formas subsiguientes se retiran una posición en la colección.

También puede quitar Shape utilizando el método de RemoveAt , quitar todas las formas mediante el método de Clear .

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 Remove en una clase derivada, asegúrese de llamar al método de Remove de la clase base para garantizar que la forma se quitará de la colección.

Ejemplos

El ejemplo siguiente muestra cómo utilizar el método de Remove para quitar Shape de un formulario si es miembro de ShapeCollectiondel formulario. Este ejemplo requiere que tenga al menos dos controles de OvalShape en un formulario.

Private Sub Form1_Click() Handles Me.Click
    Dim canvas As ShapeContainer
    ' Get the ShapeContainer.
    canvas = OvalShape1.Parent
    ' If OvalShape2 is in the same collection, remove it. 
    If canvas.Shapes.Contains(OvalShape2) Then
        canvas.Shapes.Remove(OvalShape2)
    End If 
End Sub

private void form1_Click(object sender, System.EventArgs e)
{
    ShapeContainer canvas;
    // Get the ShapeContainer.
    canvas = ovalShape1.Parent;
    // If OvalShape2 is in the same collection, remove it. 
    if (canvas.Shapes.Contains(ovalShape2))
    {
        canvas.Shapes.Remove(ovalShape2);
    }
}

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.