VisualCollection Classe

Definição

Namespace:

System.Windows.Media

Assembly:

PresentationCore.dll

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

Object

VisualCollection

Implementações

ICollection IEnumerable

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.