Comment : remplacer l'arborescence logique

Mise à jour : novembre 2007

Bien que cela ne soit pas nécessaire dans la plupart des cas, les auteurs de contrôle avancés peuvent remplacer l'arborescence logique.

Exemple

Cet exemple explique comment sous-classer StackPanel pour remplacer l'arborescence logique (dans ce cas, pour appliquer un comportement que seul le panneau peut avoir et qui restitue un seul élément enfant). Ce comportement, qui n'est pas nécessairement souhaitable, est repris dans cet exemple afin d'illustrer le scénario permettant de remplacer l'arborescence logique normale d'un élément.

public class SingletonPanel : StackPanel
{
    //private UIElementCollection _children; 
    private FrameworkElement _child;

    public SingletonPanel() {

    }

    public FrameworkElement SingleChild
    {

        get { return _child;}
        set
        {
            if (value==null) {
                 RemoveLogicalChild(_child);
            } else {             
                 if (_child==null) {
                     _child = value;
                 } else {
                     // raise an exception?
                     MessageBox.Show("Needs to be a single element");
                 }
            }
        } 
    }
    public void SetSingleChild(object child)
    {
        this.AddLogicalChild(child);
    }

    public new void AddLogicalChild(object child)
    {
        _child = (FrameworkElement)child;
        if (this.Children.Count == 1)
        {
            this.RemoveLogicalChild(this.Children[0]);
            this.Children.Add((UIElement)child);
        }
        else
        {
            this.Children.Add((UIElement)child);
        }
    }

    public new void RemoveLogicalChild(object child)

    {
        _child = null;
        this.Children.Clear();
    }
    protected override IEnumerator LogicalChildren
    {
       get {
       // cheat, make a list with one member and return the enumerator
       ArrayList _list = new ArrayList();
       _list.Add(_child);
       return (IEnumerator) _list.GetEnumerator();}
    }
}

Pour afficher l'exemple complet, consultez Substitution de l'arborescence logique, exemple. Pour plus d'informations sur l'arborescence logique, consultez Arborescences dans WPF.