VisualCollection Classe

Definizione

Spazio dei nomi:

System.Windows.Media

Assembly:

PresentationCore.dll

Rappresenta una raccolta ordinata di oggetti 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

Ereditarietà

Object

VisualCollection

Implementazioni

ICollection IEnumerable

Esempio

Nell'esempio seguente viene illustrato come creare un VisualCollection oggetto e aggiungervi membri.

// 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

Un VisualCollection oggetto ha un'affinità di contesto implicita. Se una routine tenta di accedere VisualCollection a da un contesto diverso rispetto al contesto del proprietario ContainerVisual, viene generata un'eccezione.

Costruttori

VisualCollection(Visual)

Inizializza una nuova istanza della classe VisualCollection.

Proprietà

Capacity	Ottiene o imposta il numero di elementi che VisualCollection può contenere.
Count	Ottiene il numero di elementi nella raccolta.
IsReadOnly	Ottiene un valore che indica se VisualCollection è di sola lettura.
IsSynchronized	Ottiene un valore che indica se l'accesso a VisualCollection è sincronizzato (thread-safe).
Item[Int32]	Ottiene o imposta l'oggetto Visual archiviato in base all'indice in base zero dell'oggetto VisualCollection.
SyncRoot	Ottiene un oggetto che può essere usato per sincronizzare l'accesso a VisualCollection.

Metodi

Add(Visual)	Accoda un oggetto Visual alla fine dell'oggetto VisualCollection.
Clear()	Rimuove tutti gli elementi da VisualCollection.
Contains(Visual)	Restituisce un valore Boolean che indica se l'oggetto Visual specificato è incluso o meno nell'insieme.
CopyTo(Array, Int32)	Copia gli elementi dell'insieme in una matrice, a partire da un indice di matrice specifico.
CopyTo(Visual[], Int32)	Copia l'insieme corrente nella matrice Visual passata.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetEnumerator()	Recupera un enumeratore in grado di scorrere l'oggetto VisualCollection.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
IndexOf(Visual)	Restituisce l'indice in base zero dell'oggetto Visual.
Insert(Int32, Visual)	Inserisce un elemento in VisualCollection in corrispondenza dell'indice specificato.
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
Remove(Visual)	Rimuove l'oggetto Visual specificato dall'oggetto VisualCollection.
RemoveAt(Int32)	Rimuove dall'oggetto VisualCollection l'oggetto visivo in corrispondenza dell'indice specificato.
RemoveRange(Int32, Int32)	Rimuove un intervallo di oggetti visivi dall'oggetto VisualCollection.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Implementazioni dell'interfaccia esplicita

IEnumerable.GetEnumerator()

Questo membro supporta l'infrastruttura WPF e non deve essere usato direttamente dal codice. Per una descrizione di questo membro, vedere GetEnumerator().

Metodi di estensione