FrameworkElement.RemoveLogicalChild(Object) Yöntem

Tanım

Sağlanan nesneyi bu öğenin mantıksal ağacından kaldırır. FrameworkElement etkilenen mantıksal ağaç üst işaretçilerini bu silme işlemiyle eşitlenmiş durumda tutmak için güncelleştirir.

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)

Parametreler

child
Object

Kaldırılacak öğe.

Örnekler

Aşağıdaki örnek, kendi görsel katmanı uygulamasını gerçekleştiren özel bir FrameworkElement özellik uygularChild. Özelliğin ayarlayıcısı, değer değişirse eski değerin mantıksal ağaçtan yanı sıra sınıfa özgü bir görsel koleksiyondan kaldırılacak şekilde tasarlanmıştır. Değerler önbelleğe alınır ve ardından yeni değer hem standart WPF çerçevesi düzeyi mantıksal ağacına hem de özel görsel koleksiyonuna eklenir.

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

Açıklamalar

Bir öğenin mantıksal alt öğelerini temsil eden nesnelerde koleksiyonların uygulanması için bu yöntemi kullanın. Bu, özellik alma aracılarında veya ayarlayıcılarında, olayların sınıf işleyicilerinde, oluşturucularda Changed veya koleksiyon türlerinin içinde yapılabilir.

Sağlanan temel denetim sınıfının içerik modellerinden hiçbiri uygun olmadığı sürece, denetim yazarları için bu düzeyde mantıksal ağacı düzenlemek önerilen bir uygulama değildir. , ve HeaderedItemsControldüzeyinde ContentControlItemsControlalt sınıf oluşturmayı göz önünde bulundurun. Bu sınıflar, ayrılmış API'ler aracılığıyla mantıksal alt öğeleri belirli bir şekilde zorunlu kılmanın yanı sıra genellikle şablonlar aracılığıyla stil oluşturma gibi wpf denetiminde istenen diğer özellikler için destek sağlayan bir içerik modeli sağlar.

Şunlara uygulanır

Ayrıca bkz.