VisualCollection VisualCollection VisualCollection VisualCollection Class

Definição

Representa uma coleção ordenada de objetos de Visual.Represents an ordered collection of Visual objects.

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
VisualCollectionVisualCollectionVisualCollectionVisualCollection
Implementações

Exemplos

O exemplo a seguir mostra como criar um VisualCollection e adicionar membros a ele.The following example shows how to create a VisualCollection and add members to it.

// 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 teste de clique usando o exemplode DrawingVisuals.For the complete sample, see Hit Test Using DrawingVisuals Sample.

Comentários

Um VisualCollection tem afinidade de contexto implícita.A VisualCollection has implied context affinity. Se um procedimento tentar acessar o VisualCollection de um contexto diferente do contexto do proprietário ContainerVisual, uma exceção será lançada.If a procedure attempts to access the VisualCollection from a different context than the context of the owning ContainerVisual, an exception is thrown.

Construtores

VisualCollection(Visual) VisualCollection(Visual) VisualCollection(Visual) VisualCollection(Visual)

Inicializa uma nova instância da classe VisualCollection.Initializes a new instance of the VisualCollection class.

Propriedades

Capacity Capacity Capacity Capacity

Obtém ou define o número de elementos que o VisualCollection pode conter.Gets or sets the number of elements that the VisualCollection can contain.

Count Count Count Count

Obtém o número de elementos na coleção.Gets the number of elements in the collection.

IsReadOnly IsReadOnly IsReadOnly IsReadOnly

Obtém um valor que indica se o VisualCollection é somente leitura.Gets a value that indicates whether the VisualCollection is read-only.

IsSynchronized IsSynchronized IsSynchronized IsSynchronized

Obtém um valor que indica se o acesso a VisualCollection é sincronizado (thread-safe).Gets a value that indicates whether access to the VisualCollection is synchronized (thread-safe).

Item[Int32] Item[Int32] Item[Int32] Item[Int32]

Obtém ou define o Visual que é armazenado no índice de base zero da VisualCollection.Gets or sets the Visual that is stored at the zero-based index of the VisualCollection.

SyncRoot SyncRoot SyncRoot SyncRoot

Obtém um objeto que pode ser usado para sincronizar o acesso ao VisualCollection.Gets an object that can be used to synchronize access to the VisualCollection.

Métodos

Add(Visual) Add(Visual) Add(Visual) Add(Visual)

Acrescenta um Visual ao final da VisualCollection.Appends a Visual to the end of the VisualCollection.

Clear() Clear() Clear() Clear()

Remove todos os elementos do VisualCollection.Removes all elements from the VisualCollection.

Contains(Visual) Contains(Visual) Contains(Visual) Contains(Visual)

Retorna um valor Boolean que indica se o Visual especificado está contido na coleção.Returns a Boolean value that indicates whether the specified Visual is contained in the collection.

CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32)

Copia os itens na coleção para uma matriz, começando em um índice de matriz específico.Copies the items in the collection to an array, starting at a specific array index.

CopyTo(Visual[], Int32) CopyTo(Visual[], Int32) CopyTo(Visual[], Int32) CopyTo(Visual[], Int32)

Copia a coleção atual na matriz Visual passada.Copies the current collection into the passed Visual array.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

Recupera um enumerador que pode iterar na VisualCollection.Retrieves an enumerator that can iterate through the VisualCollection.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Inherited from Object)
IndexOf(Visual) IndexOf(Visual) IndexOf(Visual) IndexOf(Visual)

Retorna o índice de base zero de Visual.Returns the zero-based index of the Visual.

Insert(Int32, Visual) Insert(Int32, Visual) Insert(Int32, Visual) Insert(Int32, Visual)

Insere um elemento no VisualCollection, no índice especificado.Inserts an element into the VisualCollection at the specified index.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Inherited from Object)
Remove(Visual) Remove(Visual) Remove(Visual) Remove(Visual)

Remove o objeto Visual especificado da VisualCollection.Removes the specified Visual object from the VisualCollection.

RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32)

Remove o objeto visual no índice especificado na VisualCollection.Removes the visual object at the specified index in the VisualCollection.

RemoveRange(Int32, Int32) RemoveRange(Int32, Int32) RemoveRange(Int32, Int32) RemoveRange(Int32, Int32)

Remove um intervalo de objetos visuais da VisualCollection.Removes a range of visual objects from the VisualCollection.

ToString() ToString() ToString() ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Inherited from Object)

Implantações explícitas de interface

IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator()

Este membro dá suporte à infraestrutura WPFWPF e não se destina a ser usado diretamente do código.This member supports the WPFWPF infrastructure and is not intended to be used directly from your code. Para obter uma descrição desse membro, consulte GetEnumerator().For a description of this member, see GetEnumerator().

Métodos de Extensão

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

Converte os elementos de um IEnumerable para o tipo especificado.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

Filtra os elementos de um IEnumerable com base em um tipo especificado.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

Habilita a paralelização de uma consulta.Enables parallelization of a query.

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

Converte um IEnumerable em um IQueryable.Converts an IEnumerable to an IQueryable.

Aplica-se a