Classe ShapeCollection

Artigo
05/17/2015

Representa uma coleção de objetos Shape.

Hierarquia de herança

Object
Microsoft.VisualBasic.PowerPacks.ShapeCollection

Namespace: Microsoft.VisualBasic.PowerPacks
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (em Microsoft.VisualBasic.PowerPacks.Vs.dll)

Sintaxe

'Declaração
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

O tipo ShapeCollection expõe os membros a seguir.

Construtores

	Nome	Descrição
	ShapeCollection	Inicializa uma nova instância da classe ShapeCollection.

Superior

Propriedades

	Nome	Descrição
	Count	Obtém o número de formas na coleção.
	IsReadOnly	Obtém um valor indicando se uma coleção é somente leitura.
	Item	Obtém o Shape no local especificado indexados local na coleção.
	Owner	Obtém o ShapeContainer , que possui o ShapeCollection.

Superior

Métodos

	Nome	Descrição
	Add	Adiciona o especificado Shape para o ShapeCollection.
	AddRange	Adiciona uma matriz de Shape objetos para o ShapeCollection.
	Clear	Remove todas as formas da coleção.
	Contains	Determina se o especificado Shape é um membro da coleção.
	ContainsKey	Determina se a ShapeCollection contém um item com a chave especificada.
	CopyTo	Copia todo o ShapeCollection para um compatível unidimensional Array, inicial no índice da matriz de destino especificado.
	Dispose	Libera os recursos não gerenciados usados pela ShapeCollection.
	Equals	Determines whether the specified object is equal to the current object. (Herdado de Object.)
	GetChildIndex(Shape)	Recupera o índice especificado Shape na ShapeCollection.
	GetChildIndex(Shape, Boolean)	Recupera o índice especificado Shape na ShapeCollectione, opcionalmente, gera uma exceção, se especificado Shape não estiver a ShapeCollection.
	GetEnumerator	Recupera uma referência a um objeto de enumerador que é usado para iterar em um ShapeCollection.
	GetHashCode	Serves as the default hash function. (Herdado de Object.)
	GetType	Gets the Type of the current instance. (Herdado de Object.)
	IndexOf	Recupera o índice especificado Shape na ShapeCollection.
	IndexOfKey	Recupera o índice da primeira ocorrência do item especificado na coleção.
	Remove	Remove o especificado Shape partir do ShapeCollection.
	RemoveAt	Remove um Shape da ShapeCollection no local especificado indexados local.
	SetChildIndex	Define o índice especificado Shape na ShapeCollection o valor de índice especificado.
	ToString	Returns a string that represents the current object. (Herdado de Object.)

Superior

Implementações explícitas da interface

	Nome	Descrição
	IList.Add
	IList.Contains
	ICollection.CopyTo
	IList.IndexOf
	IList.Insert
	IList.IsFixedSize
	ICollection.IsSynchronized
	IList.Remove
	ICollection.SyncRoot

Superior

Comentários

O Add, Remove, e RemoveAt métodos permitem que você adicionar e remover formas individuais da coleção. Você também pode usar o AddRange ou Clear método para adicionar ou remover todas as formas da coleção.

Você pode determinar se um Shape é um membro da coleção, passando a forma para o Contains método. Para obter o valor de índice da localização de uma forma na coleção, passe a forma para o IndexOf método. Você pode copiar a coleção em uma matriz chamando o CopyTo método.

Exemplos

O seguinte código exemplo remove uma Shape partir do ShapeCollection de um formulário se ele for um membro da coleção. O exemplo requer que você tenha um LineShape, um OvalShapee um RectangleShape controle em um formulário. Quando uma forma é clicada, ele é removido do ShapeCollection a menos que ele seja a última forma na coleção.

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

Acesso thread-safe

Quaisquer membros estático (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.