FrameworkElement.AddLogicalChild(Object) メソッド


指定したオブジェクトをこの要素の論理ツリーに追加します。Adds the provided object to the logical tree of this element.

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)



追加される子要素。Child element to be added.

次の例では、 Child 独自のビジュアル層の実装を行うカスタムのプロパティを実装 FrameworkElement しています。The following example implements a Child property on a custom FrameworkElement that does its own visual layer implementation. プロパティセッターは、値が変更された場合に、クラス固有のビジュアルコレクションだけでなく、論理ツリーから古い値が削除されるように設計されています。The property 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. プロパティ値がキャッシュされ、新しい値が論理ツリーとカスタムビジュアルコレクションの両方に追加されます。The property value is cached, and then the new value is added to both the logical tree and the custom visual collection.

public virtual UIElement Child
        return _child;
        if (_child != value)
            //need to remove old element from logical tree
            if (_child != null)


            if (value != null)
                //add to visual
                //add to logical

            //always add the overlay child back into the visual tree if its set
            if (_overlayVisual != null)

            //cache the new child
            _child = value;

            //notify derived types of the new child
            if (value != null)

<System.ComponentModel.DefaultValue(GetType(Object), Nothing)>
Public Overridable Property Child() As UIElement
        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
            End If


            If value IsNot Nothing Then
                'add to visual
                'add to logical
            End If

            'always add the overlay child back into the visual tree if its set
            If _overlayVisual IsNot Nothing Then
            End If

            'cache the new child
            _child = value

            'notify derived types of the new child
            If value IsNot Nothing Then
            End If

        End If
    End Set
End Property


このメソッドは、要素の論理上の子要素を表すオブジェクトのコレクションの実装に使用します。Use this method for the implementation of collections on objects that represent logical child elements of an element. 子要素コレクションのコレクションのメンテナンスは、プロパティの getter または setter、変更されたイベントのクラス処理、コンストラクター、またはコレクション型自体で行うことができます。Collection maintenance for child element collections might be done in property getters or setters, class handling of Changed events, constructors, or within the collection types themselves.

コントロールの作成者にとっては、このレベルで論理ツリーを操作することは推奨されません。ただし、使用できる基本コントロールクラスのコンテンツモデルが制御シナリオに適していない場合は除きます。For control authors, manipulating the logical tree at this level is not the recommended practice, unless none of the content models for available base control classes are appropriate for your control scenario. 、、およびのレベルでサブクラス化することを検討してください ContentControl ItemsControl HeaderedItemsControlConsider subclassing at the level of ContentControl, ItemsControl, and HeaderedItemsControl. これらのクラスは、専用の Api を使用して論理ツリーの子要素を適用するコンテンツモデルを提供します。また、テンプレートを使用したスタイル設定などの WPF コントロールで通常は望ましい他の機能をサポートします。These classes provide a content model with particular enforcement of logical tree child elements through dedicated APIs, as well as support for other features typically desirable in a WPF control such as styling through templates. との使用方法の詳細に LogicalChildren つい AddLogicalChild ては、「 WPF のツリー」を参照してください。For more information on how to use LogicalChildren and AddLogicalChild, see Trees in WPF.

AddLogicalChild は、論理ツリーが別のプロセスによって反復処理されている場合に、例外をスローすることがあります。AddLogicalChild may throw an exception if called at a time when the logical tree is being iterated by another process.