FrameworkElement.AddLogicalChild(Object) FrameworkElement.AddLogicalChild(Object) FrameworkElement.AddLogicalChild(Object) FrameworkElement.AddLogicalChild(Object) Method

Définition

Ajoute l'objet fourni à l'arborescence logique de cet élément.Adds the provided object to the logical tree of this element.

protected public:
 void AddLogicalChild(System::Object ^ child);
protected internal void AddLogicalChild (object child);
member this.AddLogicalChild : obj -> unit
Protected Friend Sub AddLogicalChild (child As Object)

Paramètres

child
Object Object Object Object

Élément enfant à ajouter.Child element to be added.

Exemples

L’exemple suivant implémente un Child propriété sur personnalisé FrameworkElement qui effectue sa propre implémentation de la couche visuelle.The following example implements a Child property on a custom FrameworkElement that does its own visual layer implementation. L’accesseur Set de propriété est conçue afin que si la valeur change, l’ancienne valeur est supprimée à partir de l’arborescence logique, ainsi que d’une collection visuelle spécifique à la classe.The property setter is designed so that if the value changes, the old value is removed from the logical tree, as well as a class-specific visual collection. La valeur de propriété est mis en cache, et ensuite la nouvelle valeur est ajoutée à l’arborescence logique et la collection visuelle personnalisée.The property value is cached, and then the new value is added to both the logical tree and the custom visual collection.

public virtual UIElement Child
{
    get
    {
        return _child;
    }
    set
    {
        if (_child != value)
        {
            //need to remove old element from logical tree
            if (_child != null)
            {
                OnDetachChild(_child);
                RemoveLogicalChild(_child);
            }

            _vc.Clear();

            if (value != null)
            {
                //add to visual
                _vc.Add(value);
                //add to logical
                AddLogicalChild(value);
            }

            //always add the overlay child back into the visual tree if its set
            if (_overlayVisual != null)
                _vc.Add(_overlayVisual);

            //cache the new child
            _child = value;

            //notify derived types of the new child
            if (value != null)
                OnAttachChild(_child);

            InvalidateMeasure();
        }
    }
}
<System.ComponentModel.DefaultValue(GetType(Object), Nothing)>
Public Overridable Property Child() As UIElement
    Get
        Return _child
    End Get
    Set(ByVal value As UIElement)
        If _child IsNot value Then
            'need to remove old element from logical tree
            If _child IsNot Nothing Then
                OnDetachChild(_child)
                RemoveLogicalChild(_child)
            End If

            _vc.Clear()

            If value IsNot Nothing Then
                'add to visual
                _vc.Add(value)
                'add to logical
                AddLogicalChild(value)
            End If

            'always add the overlay child back into the visual tree if its set
            If _overlayVisual IsNot Nothing Then
                _vc.Add(_overlayVisual)
            End If

            'cache the new child
            _child = value

            'notify derived types of the new child
            If value IsNot Nothing Then
                OnAttachChild(_child)
            End If

            InvalidateMeasure()
        End If
    End Set
End Property

Remarques

Utilisez cette méthode pour l’implémentation de collections sur les objets qui représentent les éléments enfants logiques d’un élément.Use this method for the implementation of collections on objects that represent logical child elements of an element. La maintenance des collections d’éléments enfants peut-être être effectuée dans les accesseurs Get ou les accesseurs Set, gestion des événements Changed, constructeurs, ou dans les types de collections eux-mêmes de classe.Collection maintenance for child element collections might be done in property getters or setters, class handling of Changed events, constructors, or within the collection types themselves.

Pour les auteurs de contrôle, la manipulation de l’arborescence logique à ce niveau n’est pas recommandé, sauf si aucun des modèles de contenu pour les classes de contrôle de base disponibles sont adaptées à votre scénario de contrôle.For control authors, manipulating the logical tree at this level is not the recommended practice, unless none of the content models for available base control classes are appropriate for your control scenario. Considérez le sous-classement au niveau de ContentControl, ItemsControl, et HeaderedItemsControl.Consider subclassing at the level of ContentControl, ItemsControl, and HeaderedItemsControl. Ces classes fournissent un modèle de contenu avec la mise en œuvre spécifique d’éléments enfants d’arborescence logique via dédié APIAPIs, ainsi que la prise en charge d’autres fonctionnalités généralement souhaitables dans un WPFWPF contrôle comme style via des modèles.These classes provide a content model with particular enforcement of logical tree child elements through dedicated APIAPIs, as well as support for other features typically desirable in a WPFWPF control such as styling through templates. Pour plus d’informations sur l’utilisation LogicalChildren et AddLogicalChild, consultez arborescences dans WPF.For more information on how to use LogicalChildren and AddLogicalChild, see Trees in WPF.

AddLogicalChild peut de lever une exception si elle est appelée à la fois lorsque l’arborescence logique est itérée par un autre processus.AddLogicalChild may throw an exception if called at a time when the logical tree is being iterated by another process.

S’applique à

Voir aussi