ShapeCollection (Clase)

Artículo
09/04/2008

Actualización: noviembre 2007

Representa una colección de objetos Shape.

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

Sintaxis

Public NotInheritable Class ShapeCollection _
    Implements IList, IDisposable

Dim instance As ShapeCollection

public sealed class ShapeCollection : IList, 
    IDisposable

public ref class ShapeCollection sealed : IList, 
    IDisposable

public final class ShapeCollection implements IList, IDisposable

Comentarios

Los métodos Add, Remove y RemoveAt permiten agregar y quitar formas individuales de la colección. Se puede utilizar también el método AddRange o Clear para agregar o quitar todas las formas de la colección.

Para determinar si un Shape es miembro de la colección, pase la forma al método Contains. Para obtener el valor de índice de la ubicación de una forma de la colección, pase la forma al método IndexOf. Para copiar la colección en una matriz, llame al método CopyTo.

Ejemplos

El ejemplo de código siguiente quita Shape de ShapeCollection de un formulario si es un miembro de la colección. El ejemplo requiere que tenga un control LineShape, RectangleShape y OvalShape en un formulario. Cuando se hace clic en una forma, se quita de ShapeCollection a menos que sea la última forma de la colección.

Private Sub Shapes_Click(ByVal sender As System.Object, _
 ByVal e As System.EventArgs) Handles RectangleShape1.Click, _
 OvalShape1.Click, LineShape1.Click
    ' Determine whether the shape is in the collection.
    If ShapeContainer1.Shapes.Contains(sender) Then
        ' If the Index is greater than 0, remove the shape.
        If ShapeContainer1.Shapes.IndexOf(sender) > 0 Then
            ShapeContainer1.Shapes.Remove(sender)
        End If
    End If
End Sub

private void Shapes_Click(System.Object sender, System.EventArgs e)
{
    // Determine whether the shape is in the collection.
    if (shapeContainer1.Shapes.Contains((Shape)sender))
    // If the Index is greater than 0, remove the shape.
    {
        if (shapeContainer1.Shapes.IndexOf((Shape)sender) > 0)
        {
            shapeContainer1.Shapes.Remove((Shape)sender);
        }
    }
}

Jerarquía de herencia

System.Object
Microsoft.VisualBasic.PowerPacks.ShapeCollection

Seguridad para subprocesos

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.