FrameworkElement.RemoveLogicalChild(Object) FrameworkElement.RemoveLogicalChild(Object) FrameworkElement.RemoveLogicalChild(Object) FrameworkElement.RemoveLogicalChild(Object) Method


指定されたオブジェクトをこの要素の論理ツリーから削除します。Removes the provided object from this element's logical tree. FrameworkElement は、この削除との同期を維持するために影響を受ける論理ツリーの親ポインターを更新します。FrameworkElement updates the affected logical tree parent pointers to keep in sync with this deletion.

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)


Object Object Object Object

削除する要素。The element to remove.

次の例では、実装、Childカスタム プロパティFrameworkElement独自のビジュアル層の実装を行うことです。The following example implements a Child property on a custom FrameworkElement that does its own visual layer implementation. プロパティの set アクセス操作子では、古い値をクラスに固有のビジュアルのコレクションと同様に、論理ツリーから削除、値が変更された場合ように設計されています。The property's 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. 値がキャッシュされ、標準的な WPF フレームワーク レベル論理ツリーとカスタム ビジュアルのコレクションの両方に新しい値を追加します。The values are cached, and then the new value is added to both the standard WPF framework level 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 children of an element. これは、プロパティ get アクセス操作子または set アクセス操作子のクラス ハンドラーで行うことがありますChangedイベント、コンス トラクター、またはコレクション内で自身の種類します。This might be done in property getters or setters, class handlers 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 provided base control class' content models are appropriate. サブクラス化のレベルを検討してください。 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 children through dedicated APIAPIs, as well as support for other features typically desirable in a WPFWPF control such as styling through templates.