FrameworkElement.RemoveLogicalChild(Object) FrameworkElement.RemoveLogicalChild(Object) FrameworkElement.RemoveLogicalChild(Object) FrameworkElement.RemoveLogicalChild(Object) Method

Definition

Entfernt das angegebene Objekt aus der logischen Struktur dieses Elements.Removes the provided object from this element's logical tree. FrameworkElement aktualisiert die übergeordneten Zeiger des betroffenen logischen Baums, um ihn mit der Löschung synchron zu halten.FrameworkElement updates the affected logical tree parent pointers to keep in sync with this deletion.

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

Parameter

child
Object Object Object Object

Das zu entfernende Element.The element to remove.

Beispiele

Das folgende Beispiel implementiert eine Child Eigenschaft in einem benutzerdefinierten FrameworkElement , die eine eigene Implementierung der visuellen Ebene ist.The following example implements a Child property on a custom FrameworkElement that does its own visual layer implementation. Den Setter der Eigenschaft ist so konzipiert, dass wenn der Wert ändert, der alte Wert aus der logischen Struktur als auch eine visuelle Sammlung von mandantenklassen geltenden schemaanpassungen entfernt wird.The property's 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. Die Werte werden zwischengespeichert, und der neue Wert wird dann sowohl die standardmäßigen WPF-Framework auf logische Struktur und der Sammlung von benutzerdefinierten visual hinzugefügt.The values are cached, and then the new value is added to both the standard WPF framework level 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

Hinweise

Verwenden Sie diese Methode für die Implementierung von Sammlungen für Objekte, die logischen untergeordneten Elemente eines Elements darstellen.Use this method for the implementation of collections on objects that represent logical children of an element. Dies kann erfolgen, in der Eigenschaftengetter oder Setter, Klassenhandler von Changed Ereignisse, Konstruktoren, oder in der Auflistung selbst.This might be done in property getters or setters, class handlers of Changed events, constructors, or within the collection types themselves.

Für Autoren von Steuerelementen bearbeiten die logische Struktur auf dieser Ebene nicht die empfohlene Vorgehensweise besteht, wenn keines der Klasse bereitgestellten Basissteuerelement Inhaltsmodelle geeignet sind.For control authors, manipulating the logical tree at this level is not the recommended practice, unless none of the provided base control class' content models are appropriate. Betrachten Sie Unterklassen auf der Ebene der ContentControl, ItemsControl, und HeaderedItemsControl.Consider subclassing at the level of ContentControl, ItemsControl, and HeaderedItemsControl. Diese Klassen bieten ein Inhaltsmodell mit bestimmten Durchsetzung von logischen untergeordneten Elemente über dedizierte APIsAPIs, sowie Unterstützung für andere Funktionen, die in der Regel erwünscht, in einem WPFWPF Steuerelement wie die Formatierung mithilfe von Vorlagen.These classes provide a content model with particular enforcement of logical children through dedicated APIsAPIs, as well as support for other features typically desirable in a WPFWPF control such as styling through templates.

Gilt für:

Siehe auch