FrameworkElement.AddLogicalChild(Object) Metodo

Definizione

Aggiunge l'oggetto fornito alla struttura ad albero logica di questo elemento.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)

Parametri

child
Object

Elemento figlio da aggiungere.Child element to be added.

Esempio

Nell'esempio seguente viene implementata una proprietà Child in un FrameworkElement personalizzato che esegue una propria implementazione del livello visivo.The following example implements a Child property on a custom FrameworkElement that does its own visual layer implementation. Il setter della proprietà è progettato in modo che, se il valore viene modificato, il valore precedente viene rimosso dall'albero logico, nonché da una raccolta visiva specifica della 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. Il valore della proprietà viene memorizzato nella cache, quindi il nuovo valore viene aggiunto sia all'albero logico che alla raccolta di oggetti visivi personalizzati.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

Commenti

Utilizzare questo metodo per l'implementazione di raccolte di oggetti che rappresentano gli elementi figlio logici di un elemento.Use this method for the implementation of collections on objects that represent logical child elements of an element. La manutenzione della raccolta per le raccolte di elementi figlio può essere eseguita in getter o setter di proprietà, gestione delle classi di eventi modificati, costruttori o all'interno dei tipi di raccolta stessi.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.

Per gli autori di controlli, la modifica dell'albero logico a questo livello non è la procedura consigliata, a meno che nessuno dei modelli di contenuto per le classi di controllo di base disponibili sia appropriato per lo scenario di controllo.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. Prendere in considerazione la sottoclasse al livello di ContentControl, ItemsControle HeaderedItemsControl.Consider subclassing at the level of ContentControl, ItemsControl, and HeaderedItemsControl. Queste classi forniscono un modello di contenuto con particolare imposizione di elementi figlio dell'albero logico tramite API dedicate, nonché il supporto per altre funzionalità in genere auspicabile in un controllo WPFWPF come lo stile tramite modelli.These classes provide a content model with particular enforcement of logical tree child elements through dedicated APIs, as well as support for other features typically desirable in a WPFWPF control such as styling through templates. Per ulteriori informazioni sull'utilizzo di LogicalChildren e AddLogicalChild, vedere strutture ad albero in WPF.For more information on how to use LogicalChildren and AddLogicalChild, see Trees in WPF.

AddLogicalChild può generare un'eccezione se viene chiamato in un momento in cui l'albero logico viene iterato da un altro processo.AddLogicalChild may throw an exception if called at a time when the logical tree is being iterated by another process.

Si applica a

Vedi anche