VisualCollection Classe

Définition

Espace de noms:

System.Windows.Media

Assembly:

PresentationCore.dll

Représente une collection ordonnée d’objets 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

Héritage

Object

VisualCollection

Implémente

ICollection IEnumerable

Exemples

L’exemple suivant montre comment créer un VisualCollection membre et y ajouter des membres.

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

Notes

Pour obtenir l’exemple complet, consultez Hit Test Using DrawingVisuals Sample.

Remarques

A VisualCollection une affinité de contexte implicite. Si une procédure tente d’accéder VisualCollection à partir d’un contexte différent du contexte du propriétaire ContainerVisual, une exception est levée.

Constructeurs

VisualCollection(Visual)

Initialise une nouvelle instance de la classe VisualCollection.

Propriétés

Capacity	Obtient ou définit le nombre d'éléments que VisualCollection peut contenir.
Count	Obtient le nombre d’éléments de la collection.
IsReadOnly	Obtient une valeur qui indique si l’objet VisualCollection est en lecture seule.
IsSynchronized	Obtient une valeur qui indique si l’accès à VisualCollection est synchronisé (thread-safe).
Item[Int32]	Obtient ou définit le Visual stocké à l'index de base zéro de VisualCollection.
SyncRoot	Obtient un objet qui peut être utilisé pour synchroniser l’accès à VisualCollection.

Méthodes

Add(Visual)	Ajoute le Visual à la fin de la VisualCollection.
Clear()	Supprime tous les éléments de VisualCollection.
Contains(Visual)	Retourne une valeur Boolean qui indique si le Visual spécifié est contenu dans la collection.
CopyTo(Array, Int32)	Copie les éléments de la collection dans un tableau, en commençant par un index de tableau spécifique.
CopyTo(Visual[], Int32)	Copie la collection actuelle dans le tableau Visual passé.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetEnumerator()	Récupère un énumérateur qui peut parcourir la VisualCollection.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
IndexOf(Visual)	Retourne l'index de base zéro de Visual.
Insert(Int32, Visual)	Insère un élément dans la classe VisualCollection au niveau de l'index spécifié.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
Remove(Visual)	Supprime l'objet Visual spécifié de la VisualCollection.
RemoveAt(Int32)	Supprime l'objet visuel à l'index spécifié dans la VisualCollection.
RemoveRange(Int32, Int32)	Supprime une plage d'objets visuels de la VisualCollection.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Implémentations d’interfaces explicites

IEnumerable.GetEnumerator()

Ce membre prend en charge l’infrastructure WPF et n’est pas destiné à être utilisé directement à partir de votre code. Pour obtenir une description de ce membre, consultez GetEnumerator().

Méthodes d’extension

Cast<TResult>(IEnumerable)	Effectue un cast des éléments d'un IEnumerable vers le type spécifié.
OfType<TResult>(IEnumerable)	Filtre les éléments d'un IEnumerable en fonction du type spécifié.
AsParallel(IEnumerable)	Active la parallélisation d'une requête.
AsQueryable(IEnumerable)	Convertit un IEnumerable en IQueryable.