FrameworkElement.AddLogicalChild(Object) FrameworkElement.AddLogicalChild(Object) FrameworkElement.AddLogicalChild(Object) FrameworkElement.AddLogicalChild(Object) Method


指定したオブジェクトをこの要素の論理ツリーに追加します。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)


Object Object Object 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. プロパティ set アクセス操作子では、古い値をクラスに固有のビジュアルのコレクションと同様に、論理ツリーから削除、値が変更された場合ように設計されています。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. 子要素のコレクションのコレクションのメンテナンスは、プロパティ get アクセス操作子または set アクセス操作子のクラス処理のときに Changed イベント、コンス トラクター、またはコレクション型自体内で行われます。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. サブクラス化のレベルを検討してください。 ContentControlItemsControl、およびHeaderedItemsControlします。Consider subclassing at the level of ContentControl, ItemsControl, and HeaderedItemsControl. これらのクラスを専用の論理ツリーの子要素の特定の強制のコンテンツ モデルを提供するAPIAPIs、通常望ましい他の機能のサポートと、WPFWPFテンプレートをスタイル設定などのコントロール。These classes provide a content model with particular enforcement of logical tree child elements through dedicated APIAPIs, as well as support for other features typically desirable in a WPFWPF control such as styling through templates. 使用する方法の詳細についてのLogicalChildrenAddLogicalChildを参照してください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.