FrameworkElement.RemoveLogicalChild(Object) 메서드


이 요소의 논리적 트리에서 제공된 개체를 제거합니다.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)

매개 변수


제거할 요소입니다.The element to remove.


다음 예제에서는 Child FrameworkElement 고유한 시각적 계층 구현을 수행 하는 사용자 지정의 속성을 구현 합니다.The following example implements a Child property on a custom FrameworkElement that does its own visual layer implementation. 속성의 setter가 디자인 되어 값이 변경 되 면 이전 값은 클래스 관련 시각적 컬렉션 뿐만 아니라 논리적 트리에서 제거 됩니다.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. 이러한 작업은 속성 getter 또는 setter, 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. , 및 수준에서 서브클래싱 ContentControl 을 고려 ItemsControl HeaderedItemsControl 합니다.Consider subclassing at the level of ContentControl, ItemsControl, and HeaderedItemsControl. 이러한 클래스는 전용 Api를 통해 논리적 자식에 대 한 특정 적용을 포함 하는 콘텐츠 모델 뿐만 아니라 WPFWPF 템플릿을 통한 스타일 지정과 같은 컨트롤에서 일반적으로 사용 하는 기타 기능에 대 한 지원을 제공 합니다.These classes provide a content model with particular enforcement of logical children through dedicated APIs, as well as support for other features typically desirable in a WPFWPF control such as styling through templates.

적용 대상

추가 정보