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.

C#
protected internal void RemoveLogicalChild(object child);

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.

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

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

Ürün Sürümler
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10

Ayrıca bkz.