FrameworkElement.AddLogicalChild(Object) Methode

Definition

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Fügt der logischen Struktur dieses Elements das bereitgestellte Objekt hinzu.

C#

protected internal void AddLogicalChild(object child);

Parameter

child

Object

Das hinzuzufügende untergeordnete Element.

Beispiele

Im folgenden Beispiel wird eine Eigenschaft für eine Child benutzerdefinierte FrameworkElement Implementierung implementiert, die eine eigene Implementierung auf visueller Ebene durchführt. Der Eigenschaftensetter ist so konzipiert, dass der alte Wert aus der logischen Struktur sowie aus 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.

C#

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();
        }
    }
}

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 Eigenschaften gettern oder Settern, in 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. Erwägen Sie eine Unterklassen auf der Ebene von ContentControl, ItemsControlund HeaderedItemsControl. Diese Klassen bieten ein Inhaltsmodell mit besonderer Erzwingung von untergeordneten Elementen der logischen Struktur über dedizierte APIs sowie Unterstützung für andere Features, die normalerweise in einem WPF-Steuerelement wünschenswert sind, z. B. das Formatieren durch Vorlagen. Weitere Informationen zur Verwendung LogicalChildren von und AddLogicalChildfinden Sie unter Strukturen in WPF.

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

Gilt für:

Weitere Informationen

• RemoveLogicalChild(Object)