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 et ajouter des VisualCollection membres à celui-ci.

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

Note

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

Remarques

A VisualCollection a 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

Nom	Description
VisualCollection(Visual)	Initialise une nouvelle instance de la classe VisualCollection.

Propriétés

Nom	Description
Capacity	Obtient ou définit le nombre d’éléments que le VisualCollection conteneur 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 à l’objet VisualCollection est synchronisé (thread-safe).
Item[Int32]	Obtient ou définit l’index Visual de base zéro de l’index VisualCollection.
SyncRoot	Obtient un objet qui peut être utilisé pour synchroniser l’accès VisualCollectionau .

Méthodes

Nom	Description
Add(Visual)	Ajoute un Visual à la fin du VisualCollection.
Clear()	Supprime tous les éléments du VisualCollection.
Contains(Visual)	Retourne une Boolean valeur qui indique si le spécifié Visual 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 active dans le tableau passé Visual .
GetEnumerator()	Récupère un énumérateur qui peut itérer au sein du VisualCollection.
IndexOf(Visual)	Retourne l’index de base zéro du Visual.
Insert(Int32, Visual)	Insère un élément dans l’index VisualCollection spécifié.
Remove(Visual)	Supprime l’objet spécifié Visual de l’objet VisualCollection.
RemoveAt(Int32)	Supprime l’objet visuel à l’index spécifié dans le VisualCollection.
RemoveRange(Int32, Int32)	Supprime une plage d’objets visuels du VisualCollection.

Implémentations d’interfaces explicites

Nom	Description
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().