Visual.RemoveVisualChild(Visual) Méthode

Définition

Espace de noms:

System.Windows.Media

Assembly:

PresentationCore.dll

Supprime la relation parent-enfant entre deux objets visuels.

C#

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

Paramètres

child

Visual

Objet visuel enfant à supprimer de 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 RemoveVisualChild méthode supprime la relation parent-enfant entre deux visuels. Cette méthode, ainsi que la AddVisualChild méthode , doivent être utilisées 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