Compartilhar via


VisualCollection Classe

Definição

Representa uma coleção ordenada de objetos de Visual.

public ref class VisualCollection sealed : System::Collections::ICollection
public sealed class VisualCollection : System.Collections.ICollection
type VisualCollection = class
    interface ICollection
    interface IEnumerable
Public NotInheritable Class VisualCollection
Implements ICollection
Herança
VisualCollection
Implementações

Exemplos

O exemplo a seguir mostra como criar e VisualCollection adicionar membros a ele.

// Create a host visual derived from the FrameworkElement class.
// This class provides layout, event handling, and container support for
// the child visual objects.
public class MyVisualHost : FrameworkElement
{
    // Create a collection of child visual objects.
    private VisualCollection _children;

    public MyVisualHost()
    {
        _children = new VisualCollection(this);
        _children.Add(CreateDrawingVisualRectangle());
        _children.Add(CreateDrawingVisualText());
        _children.Add(CreateDrawingVisualEllipses());

        // Add the event handler for MouseLeftButtonUp.
        this.MouseLeftButtonUp += new System.Windows.Input.MouseButtonEventHandler(MyVisualHost_MouseLeftButtonUp);
    }
' Create a host visual derived from the FrameworkElement class.
' This class provides layout, event handling, and container support for
' the child visual objects.
Public Class MyVisualHost
    Inherits FrameworkElement
    ' Create a collection of child visual objects.
    Private _children As VisualCollection

    Public Sub New()
        _children = New VisualCollection(Me)
        _children.Add(CreateDrawingVisualRectangle())
        _children.Add(CreateDrawingVisualText())
        _children.Add(CreateDrawingVisualEllipses())

        ' Add the event handler for MouseLeftButtonUp.
        AddHandler MouseLeftButtonUp, AddressOf MyVisualHost_MouseLeftButtonUp
    End Sub

Observação

Para obter o exemplo completo, consulte o teste de clique usando o exemplo DrawingVisuals.

Comentários

A VisualCollection tem afinidade de contexto implícita. Se um procedimento tentar acessar a VisualCollection partir de um contexto diferente do contexto da propriedade ContainerVisual, uma exceção será gerada.

Construtores

VisualCollection(Visual)

Inicializa uma nova instância da classe VisualCollection.

Propriedades

Capacity

Obtém ou define o número de elementos que o VisualCollection pode conter.

Count

Obtém o número de elementos na coleção.

IsReadOnly

Obtém um valor que indica se o VisualCollection é somente leitura.

IsSynchronized

Obtém um valor que indica se o acesso a VisualCollection é sincronizado (thread-safe).

Item[Int32]

Obtém ou define o Visual que é armazenado no índice de base zero da VisualCollection.

SyncRoot

Obtém um objeto que pode ser usado para sincronizar o acesso ao VisualCollection.

Métodos

Add(Visual)

Acrescenta um Visual ao final da VisualCollection.

Clear()

Remove todos os elementos do VisualCollection.

Contains(Visual)

Retorna um valor Boolean que indica se o Visual especificado está contido na coleção.

CopyTo(Array, Int32)

Copia os itens na coleção para uma matriz, começando em um índice de matriz específico.

CopyTo(Visual[], Int32)

Copia a coleção atual na matriz Visual passada.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetEnumerator()

Recupera um enumerador que pode iterar na VisualCollection.

GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
IndexOf(Visual)

Retorna o índice de base zero de Visual.

Insert(Int32, Visual)

Insere um elemento no VisualCollection, no índice especificado.

MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
Remove(Visual)

Remove o objeto Visual especificado da VisualCollection.

RemoveAt(Int32)

Remove o objeto visual no índice especificado na VisualCollection.

RemoveRange(Int32, Int32)

Remove um intervalo de objetos visuais da VisualCollection.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Implantações explícitas de interface

IEnumerable.GetEnumerator()

Esse membro dá suporte à infraestrutura do WPF e não se destina a ser usado diretamente do seu código. Para obter uma descrição desse membro, confira GetEnumerator().

Métodos de Extensão

Cast<TResult>(IEnumerable)

Converte os elementos de um IEnumerable para o tipo especificado.

OfType<TResult>(IEnumerable)

Filtra os elementos de um IEnumerable com base em um tipo especificado.

AsParallel(IEnumerable)

Habilita a paralelização de uma consulta.

AsQueryable(IEnumerable)

Converte um IEnumerable em um IQueryable.

Aplica-se a