FrameworkElementAutomationPeer.FromElement(UIElement) 메서드

정의

네임스페이스:

Microsoft.UI.Xaml.Automation.Peers

지정된 UIElement에 대한 FrameworkElementAutomationPeer를 반환합니다.

public:
 static AutomationPeer ^ FromElement(UIElement ^ element);

 static AutomationPeer FromElement(UIElement const& element);

public static AutomationPeer FromElement(UIElement element);

function fromElement(element)

Public Shared Function FromElement (element As UIElement) As AutomationPeer

매개 변수

element

UIElement

이 FrameworkElementAutomationPeer와 연결된 UIElement입니다.

반환

AutomationPeer

FrameworkElementAutomationPeer 또는 FrameworkElementAutomationPeer를 만들 수 없는 경우 null입니다.

예제

자동화 지원 디자인은 피어가 실제로 만들어지는 시기를 보장하지 않으므로 OnCreateAutomationPeer를 구현하는 방법의 일부로 사용자 고유의 피어에 대한 핸들을 유지하지 않습니다. 대신 다음과 같은 코드를 사용하여 컨트롤 클래스 정의 Just-In-Time 내에서 런타임 자동화 이벤트 수신기를 검사 수 있습니다.

if (AutomationPeer.ListenerExists(AutomationEvents.PropertyChanged))
{
    MyAutomationPeer peer = 
        FrameworkElementAutomationPeer.FromElement(myCtrl) as MyAutomationPeer;

    if (peer != null)
    {
        peer.RaisePropertyChangedEvent(
            RangeValuePatternIdentifiers.ValueProperty,
            (double)oldValue,
            (double)newValue);
    }
}

설명

FromElement는 사용자 지정 컨트롤 코드에서 작동하는 피어 instance 반환하는 데 사용되는 도우미 클래스입니다. 반환된 피어를 사용하여 일반 제어 논리 이벤트를 발생하거나 컨트롤 속성을 변경하는 동일한 루틴 내에서 자동화 이벤트를 실행할 수 있습니다. 또는 이 작업을 수행하고 제어 논리에서 호출되는 고유한 도우미 메서드를 작성할 수 있습니다.

CreatePeerForElement 에는 기본적으로 FromElement와 동일한 동작이 있습니다.

FromElement가 null을 반환하는 경우 전달한 요소 에 OnCreateAutomationPeer에 대한 구현이 없기 때문일 수 있습니다.

어떤 이유로 인해 요소 대상에서 CreateAutomationPeer 시스템 논리가 아직 실행되지 않은 경우에도 FromElement는 피어를 반환할 수 있습니다. 피어를 가져오기 위해 동일한 CreateAutomationPeer 논리를 내부적으로 호출합니다.

추가 정보

• CreatePeerForElement(UIElement)