FrameworkElement.AddLogicalChild(Object) Metodo

Definizione

Spazio dei nomi:

System.Windows

Assembly:

PresentationFramework.dll

Aggiunge l'oggetto fornito alla struttura ad albero logica di questo elemento.

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.

Esempio

Nell'esempio seguente viene implementata una Child proprietà in un oggetto personalizzato FrameworkElement che esegue la propria implementazione del livello visivo. Il setter della proprietà è progettato in modo che, se il valore cambia, il valore precedente viene rimosso dall'albero logico, nonché da una raccolta visiva specifica della classe. Il valore della proprietà viene memorizzato nella cache e quindi il nuovo valore viene aggiunto sia all'albero logico che alla raccolta di oggetti visivi personalizzati.

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 su oggetti che rappresentano elementi figlio logici di un elemento. La manutenzione della raccolta per le raccolte di elementi figlio può essere eseguita nei getter o nei setter delle proprietà, nella gestione delle classi di eventi Modificati, nei costruttori o all'interno dei tipi di raccolta stessi.

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. Prendere in considerazione la sottoclasse a livello di ContentControl, ItemsControle HeaderedItemsControl. Queste classi forniscono un modello di contenuto con particolare imposizione degli elementi figlio dell'albero logico tramite API dedicate, nonché il supporto per altre funzionalità in genere auspicabili in un controllo WPF, ad esempio lo stile tramite modelli. Per altre informazioni su come usare LogicalChildren e AddLogicalChild, vedere Alberi in WPF.

AddLogicalChild può generare un'eccezione se viene chiamata in un momento in cui l'albero logico viene iterato da un altro processo.

Vedi anche

• RemoveLogicalChild(Object)