FrameworkElement.AddLogicalChild(Object) Yöntem

Tanım

Ad Alanı:

System.Windows

Bütünleştirilmiş Kod:

PresentationFramework.dll

Sağlanan nesneyi bu öğenin mantıksal ağacına ekler.

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)

Parametreler

child

Object

Eklenecek alt öğe.

Örnekler

Aşağıdaki örnek, kendi görsel katmanı uygulamasını gerçekleştiren özel bir FrameworkElement özellik uygularChild. Özellik ayarlayıcısı, değer değişirse eski değerin mantıksal ağaçtan ve sınıfa özgü bir görsel koleksiyondan kaldırılması için tasarlanmıştır. Özellik değeri önbelleğe alınır ve ardından yeni değer hem mantıksal ağaç 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. Alt öğe koleksiyonları için koleksiyon bakımı özellik alma aracılarında veya ayarlayıcılarda, Değiştirilen olayların, oluşturucuların sınıf işlemesinde veya koleksiyon türlerinin içinde yapılabilir.

Denetim yazarları için, kullanılabilir temel denetim sınıflarının içerik modellerinden hiçbiri denetim senaryonuz için uygun olmadığı sürece, 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 ağaç alt öğelerinin belirli bir şekilde uygulanmasına sahip bir içerik modeli ve şablonlar aracılığıyla stil oluşturma gibi bir WPF denetiminde genellikle istenen diğer özellikler için destek sağlar. ve AddLogicalChildkullanma hakkında daha fazla bilgi için LogicalChildren bkz. WPF'deki ağaçlar.

AddLogicalChild mantıksal ağacın başka bir işlem tarafından yinelendiği bir zamanda çağrılırsa bir özel durum oluşturabilir.

Ayrıca bkz.

• RemoveLogicalChild(Object)