다음을 통해 공유


AutomationPeer.GetPatternCore(PatternInterface) 메서드

정의

Microsoft UI 자동화 클라이언트가 GetPattern 또는 동등한 Microsoft UI 자동화 클라이언트 API를 호출할 때 피어의 동작을 제공합니다.

protected:
 virtual Platform::Object ^ GetPatternCore(PatternInterface patternInterface) = GetPatternCore;
IInspectable GetPatternCore(PatternInterface const& patternInterface);
protected virtual object GetPatternCore(PatternInterface patternInterface);
function getPatternCore(patternInterface)
Protected Overridable Function GetPatternCore (patternInterface As PatternInterface) As Object

매개 변수

patternInterface
PatternInterface

PatternInterface 열거형의 값입니다.

반환

Object

Platform::Object

IInspectable

패턴 인터페이스를 구현하는 개체입니다. 피어가 이 인터페이스를 지원하지 않는 경우 null 입니다.

설명

기본 피어 클래스는 패턴을 지원하지 않으므로 AutomationPeer 수준의 표준 구현은 null을 반환합니다. 대부분의 기존 Windows 런타임 피어 클래스는 이 메서드를 재정의하여 특정 피어가 지원하는 패턴을 보고합니다.

피어 클래스가 지원하는 패턴의 구현을 반환하도록 이 메서드를 재정의하는 것은 자동화 피어를 구현하기 위한 가장 일반적인 시나리오 중 하나입니다. 사용자 지정 자동화 피어를 참조하세요.

참고

이 샘플은 유지 관리되지 않으며 컴파일되지 않을 수 있습니다.

OnCreateAutomationPeer에서 반환된 사용자 지정 피어를 정의하는 OnCreateAutomationPeer 구현은 XAML 접근성 샘플을 참조하세요(피어 구현은 이 샘플의 시나리오 3에 포함됨).

이전 버전에 대한 참고 사항

Windows 8.x

Windows 8 피어 선택 동작은 잠재적으로 컨트롤이 데이터를 항목으로 표시하기 위한 것인지 여부에 의해 영향을 받습니다. Windows 8 대한 자동화 논리는 전체 컨트롤에 대해 표시된 피어가 있고 해당 피어가 GetPatternCore를 재정의하더라도 전용 데이터 피어를 선택하고 해당 패턴을 사용할 수 있습니다. 예를 들어 패턴에 대해 ListViewAutomationPeer 재정의가 있을 수 있지만 Windows 8 데이터 항목에 대한 동작 패턴이 우선적으로 적용될 수 있습니다. 예를 들어 ListViewItemDataAutomationPeer의 기본 구현이 사용될 수 있으며 UI 자동화 항목에서 패턴을 검색할 때 스크롤 패턴을 처리할 수 있습니다. 이는 Windows 8.1 시작부터 다릅니다. 전체 컨트롤에 대한 GetPatternCore 구현에 패턴 지원이 표시되는 경우 해당 구현은 내부 항목 데이터 피어 대신 사용됩니다.

앱 코드를 Windows 8 Windows 8.1 마이그레이션하는 경우 항목 컨트롤 패턴 지원도 데이터 항목에 사용할 수 있고 instance 항목 스크롤에 대한 동작을 추가해야 할 수 있으므로 이 동작 변경을 고려할 수 있습니다.

Windows 8용으로 컴파일되었지만 Windows 8.1에서 실행하는 앱은 Windows 8 동작을 계속 사용합니다.

적용 대상

추가 정보