Visual.AddVisualChild(Visual) Méthode

Définition

Espace de noms:

System.Windows.Media

Assembly:

PresentationCore.dll

Définit la relation parent-enfant entre deux objets visuels.

C#

protected void AddVisualChild(System.Windows.Media.Visual child);

Paramètres

child

Visual

Objet visuel enfant à ajouter à l'objet visuel parent.

Exemples

L’exemple suivant montre comment définir des exigences de stockage personnalisées pour un enfant visuel. L’exemple utilise les AddVisualChild méthodes et RemoveVisualChild pour configurer la relation parent-enfant entre le visuel parent et child. Pour que l’arborescence visuelle soit énumérée correctement, l’exemple fournit des implémentations substituées de la méthode et VisualChildrenCount de la GetVisualChild propriété .

Note

Bien qu’il soit possible d’utiliser VisualCollection pour créer des relations parent-enfant entre des objets visuels, il est plus efficace de fournir votre propre implémentation de stockage personnalisée quand un seul enfant est lié à un parent.

C#

// Create a host visual derived from the FrameworkElement class.
// This class provides layout, event handling, and container support for
// the child visual object.
public class MyVisualHost : FrameworkElement
{
    private DrawingVisual _child;

    public MyVisualHost(DrawingVisual drawingVisual)
    {
        _child = drawingVisual;
        this.AddVisualChild(_child);
    }

    public DrawingVisual Child
    {
        get
        {
            return _child;
        }

        set
        {
            if (_child != value)
            {
                this.RemoveVisualChild(_child);
                _child = value;
                this.AddVisualChild(_child);
            }
        }
    }

    // Provide a required override for the VisualChildrenCount property.
    protected override int VisualChildrenCount
    {
        get { return _child == null ? 0 : 1; }
    }

    // Provide a required override for the GetVisualChild method.
    protected override Visual GetVisualChild(int index)
    {
        if (_child == null)
        {
            throw new ArgumentOutOfRangeException();
        }

        return _child;
    }

Remarques

La AddVisualChild méthode configure la relation parent-enfant entre deux objets visuels. Cette méthode doit être utilisée lorsque vous avez besoin d’un contrôle de bas niveau plus élevé sur l’implémentation de stockage sous-jacente des objets enfants visuels. VisualCollection peut être utilisé comme implémentation par défaut pour stocker des objets enfants.

S’applique à

Voir aussi

• VisualCollection