VisualCollection VisualCollection VisualCollection VisualCollection Class

Definizione

Rappresenta una raccolta ordinata di oggetti 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
Ereditarietà
VisualCollectionVisualCollectionVisualCollectionVisualCollection
Implementazioni

Esempi

Nell'esempio seguente viene illustrato come creare un VisualCollection e aggiungervi membri.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

Nota

Per l'esempio completo, vedere Hit Test Using DrawingVisuals Sample.For the complete sample, see Hit Test Using DrawingVisuals Sample.

Commenti

Oggetto VisualCollection presenta un'affinità contesto implicita.A VisualCollection has implied context affinity. Se una procedura tenta di accedere il VisualCollection da un contesto diverso rispetto al contesto dell'oggetto proprietario ContainerVisual, viene generata un'eccezione.If a procedure attempts to access the VisualCollection from a different context than the context of the owning ContainerVisual, an exception is thrown.

Costruttori

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

Inizializza una nuova istanza della classe VisualCollection.Initializes a new instance of the VisualCollection class.

Proprietà

Capacity Capacity Capacity Capacity

Ottiene o imposta il numero di elementi che VisualCollection può contenere.Gets or sets the number of elements that the VisualCollection can contain.

Count Count Count Count

Ottiene il numero di elementi nella raccolta.Gets the number of elements in the collection.

IsReadOnly IsReadOnly IsReadOnly IsReadOnly

Ottiene un valore che indica se VisualCollection è di sola lettura.Gets a value that indicates whether the VisualCollection is read-only.

IsSynchronized IsSynchronized IsSynchronized IsSynchronized

Ottiene un valore che indica se l'accesso a VisualCollection è sincronizzato (thread-safe).Gets a value that indicates whether access to the VisualCollection is synchronized (thread-safe).

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

Ottiene o imposta l'oggetto Visual archiviato in base all'indice in base zero dell'oggetto VisualCollection.Gets or sets the Visual that is stored at the zero-based index of the VisualCollection.

SyncRoot SyncRoot SyncRoot SyncRoot

Ottiene un oggetto che può essere usato per sincronizzare l'accesso a VisualCollection.Gets an object that can be used to synchronize access to the VisualCollection.

Metodi

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

Accoda un oggetto Visual alla fine dell'oggetto VisualCollection.Appends a Visual to the end of the VisualCollection.

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

Rimuove tutti gli elementi da VisualCollection.Removes all elements from the VisualCollection.

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

Restituisce un valore Boolean che indica se l'oggetto Visual specificato è incluso o meno nell'insieme.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 gli elementi dell'insieme in una matrice, a partire da un indice di matrice specifico.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 l'insieme corrente nella matrice Visual passata.Copies the current collection into the passed Visual array.

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

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

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

Recupera un enumeratore in grado di scorrere l'oggetto VisualCollection.Retrieves an enumerator that can iterate through the VisualCollection.

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

Funge da funzione hash predefinita.Serves as the default hash function.

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

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

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

Restituisce l'indice in base zero dell'oggetto Visual.Returns the zero-based index of the Visual.

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

Inserisce un elemento in VisualCollection in corrispondenza dell'indice specificato.Inserts an element into the VisualCollection at the specified index.

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

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

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

Rimuove l'oggetto Visual specificato dall'oggetto VisualCollection.Removes the specified Visual object from the VisualCollection.

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

Rimuove dall'oggetto VisualCollection l'oggetto visivo in corrispondenza dell'indice specificato.Removes the visual object at the specified index in the VisualCollection.

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

Rimuove un intervallo di oggetti visivi dall'oggetto VisualCollection.Removes a range of visual objects from the VisualCollection.

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

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Implementazioni dell'interfaccia esplicita

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

Questo membro supporta l'infrastruttura di WPFWPF e non deve essere usato direttamente dal codice.This member supports the WPFWPF infrastructure and is not intended to be used directly from your code. Per una descrizione di questo membro, vedere GetEnumerator().For a description of this member, see GetEnumerator().

Extension Methods

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

Esegue il cast degli elementi di un oggetto IEnumerable nel tipo specificato.Casts the elements of an IEnumerable to the specified type.

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

Filtra gli elementi di un oggetto IEnumerable in base a un tipo specificato.Filters the elements of an IEnumerable based on a specified type.

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

Consente la parallelizzazione di una query.Enables parallelization of a query.

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

Converte un' IEnumerable a un IQueryable.Converts an IEnumerable to an IQueryable.

Si applica a