ShapeCollection (Clase)

Artículo
05/17/2015

Representa una colección de objetos Shape.

Jerarquía de herencia

Object
Microsoft.VisualBasic.PowerPacks.ShapeCollection

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

Sintaxis

'Declaración
Public NotInheritable Class ShapeCollection _
    Implements IList, IDisposable

public sealed class ShapeCollection : IList, 
    IDisposable

public ref class ShapeCollection sealed : IList, 
    IDisposable

[<Sealed>]
type ShapeCollection =  
    class 
        interface IList 
        interface IDisposable 
    end

public final class ShapeCollection implements IList, IDisposable

El tipo ShapeCollection expone los siguientes miembros.

Constructores

	Nombre	Descripción
	ShapeCollection	Inicializa una nueva instancia de la clase ShapeCollection.

Arriba

Propiedades

	Nombre	Descripción
	Count	Obtiene el número de formas de la colección.
	IsReadOnly	Obtiene un valor que indica si una colección es de sólo lectura.
	Item	Obtiene el Shape que se encuentra en la ubicación indizada especificada de la colección.
	Owner	Obtiene el ShapeContainer que posee el ShapeCollection.

Arriba

Métodos

	Nombre	Descripción
	Add	Agrega el objeto Shape especificado a la colección ShapeCollection.
	AddRange	Agrega una matriz de objetos Shape al ShapeCollection.
	Clear	Quita todas las formas de la colección.
	Contains	Determina si el Shape especificado es un miembro de la colección.
	ContainsKey	Determina si la colección ShapeCollection contiene un elemento con la clave especificada.
	CopyTo	Copia toda la ShapeCollection completa a un objeto Array unidimensional compatible, a partir del índice especificado de la matriz de destino.
	Dispose	Libera los recursos no administrados que utiliza ShapeCollection.
	Equals	Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object).
	GetChildIndex(Shape)	Recupera el índice del Shape especificado en ShapeCollection.
	GetChildIndex(Shape, Boolean)	Recupera el índice del objeto Shape especificado en ShapeCollection y, opcionalmente, produce una excepción si el objeto Shape especificado no está en ShapeCollection.
	GetEnumerator	Recupera una referencia a un objeto del enumerador que se utiliza para recorrer en iteración la colección ShapeCollection.
	GetHashCode	Sirve como la función hash predeterminada. (Se hereda de Object).
	GetType	Obtiene el objeto Type de la instancia actual. (Se hereda de Object).
	IndexOf	Recupera el índice del Shape especificado en ShapeCollection.
	IndexOfKey	Devuelve el índice de la primera aparición del elemento especificado en la colección.
	Remove	Quita el Shape especificado de ShapeCollection.
	RemoveAt	Quita un objeto Shape de ShapeCollection en la ubicación de índice especificada.
	SetChildIndex	Establece del Shape especificado en ShapeCollection en el valor del índice especificado.
	ToString	Devuelve una cadena que representa el objeto actual. (Se hereda de Object).

Arriba

Implementaciones explícitas de interfaces

	Nombre	Descripción
	IList.Add
	IList.Contains
	ICollection.CopyTo
	IList.IndexOf
	IList.Insert
	IList.IsFixedSize
	ICollection.IsSynchronized
	IList.Remove
	ICollection.SyncRoot

Arriba

Comentarios

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

Puede determinar si Shape es miembro de la colección pasando la forma del método de Contains . Para obtener el valor de índice de la ubicación de una forma en la colección, pase la forma del método de IndexOf . Puede copiar la colección en una matriz llamando al método de 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 tener LineShape, OvalShape, y un control de RectangleShape 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);
        }
    }
}

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.