FrameworkElement.AddLogicalChild(Object) Methode

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)

Parameter

Beispiele

Im folgenden Beispiel wird eine Child Eigenschaft für eine benutzerdefinierte FrameworkElement Implementierung implementiert, die eine eigene Implementierung visueller Ebenen durchführt. Der Eigenschaftensatzer ist so konzipiert, dass der alte Wert aus der logischen Struktur sowie einer klassenspezifischen visuellen Auflistung entfernt wird, wenn sich der Wert ändert. Der Eigenschaftswert wird zwischengespeichert, und dann wird der neue Wert sowohl der logischen Struktur als auch der benutzerdefinierten visuellen Auflistung hinzugefügt.

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

Hinweise

Verwenden Sie diese Methode für die Implementierung von Auflistungen für Objekte, die logische untergeordnete Elemente eines Elements darstellen. Die Sammlungswartung für untergeordnete Elementsammlungen kann in Eigenschafts-Gettern oder Settern, der Klassenbehandlung von Geänderten Ereignissen, Konstruktoren oder innerhalb der Auflistungstypen selbst erfolgen.

Für Steuerelementautoren ist das Bearbeiten der logischen Struktur auf dieser Ebene nicht die empfohlene Vorgehensweise, es sei denn, keines der Inhaltsmodelle für verfügbare Basissteuerelementklassen ist für Ihr Steuerelementszenario geeignet. Berücksichtigen Sie die Unterklassen auf der Ebene von ContentControl, ItemsControlund HeaderedItemsControl. Diese Klassen bieten ein Inhaltsmodell mit einer bestimmten Erzwingung logischer untergeordneter Strukturelemente über dedizierte APIs sowie Unterstützung für andere Features, die normalerweise in einem WPF-Steuerelement wie formatieren über Vorlagen wünschenswert sind. Weitere Informationen zur Verwendung von LogicalChildren und AddLogicalChild finden Sie unter Trees in WPF.

AddLogicalChild kann eine Ausnahme auslösen, wenn sie gleichzeitig aufgerufen wird, wenn die logische Struktur von einem anderen Prozess durchlaufen wird.

Weitere Informationen

• RemoveLogicalChild(Object)