다음을 통해 공유


AutomationPeer.GetName 메서드

정의

이 자동화 피어에 연결된 요소를 설명하는 텍스트를 가져옵니다. Microsoft UI 자동화 Name 값은 Microsoft UI 자동화 프레임워크와 상호 작용하여 앱의 UI를 나타낼 때 대부분의 보조 기술에서 사용하는 기본 식별자입니다.

public:
 virtual Platform::String ^ GetName() = GetName;
winrt::hstring GetName();
public string GetName();
function getName()
Public Function GetName () As String

반환

String

Platform::String

winrt::hstring

보조 기술 및 기타 Microsoft UI 자동화 클라이언트에서 사용하는 피어의 소유자인 요소의 이름입니다.

설명

FrameworkElementAutomationPeer 는 중간 GetNameCore 구현을 제공하여 GetName 에 동작을 도입합니다. 요소에 LabeledByMicrosoft UI 자동화 속성 값이 있는 경우 레이블 지정 요소의 Name 값이 Name으로 사용됩니다.

FrameworkElementAutomationPeer는 해당 컨트롤의 콘텐츠 모델에 액세스하고 Name에 유용한 기본값을 반환하기 위해 다른 기본 피어 클래스가 재정의할 수 있는 내부 GetPlainText 메서드를 통해 동작을 도입합니다. 예를 들어 ContentControl 파생 클래스는 Content 값의 문자열 표현을 기본 이름으로 사용합니다. 이는 내부적으로 ContentControlGetPlainText를 구현하고 해당 동작을 모든 ContentControl 파생 클래스에 부여하기 때문에 사용하도록 설정됩니다. 예를 들어 Button의 문자열 값에서 유용한 Name 기본값을 가져오는 방법입니다.

다른 특정 피어에는 특정 Windows 런타임 컨트롤이 Name에 대한 기본 제공 값을 제공하는 유용한 방법을 제공하는 중간 GetNameCore 구현이 있을 수도 있습니다. 이러한 값의 원본은 일반적으로 XAML 또는 앱 사용자 코드로 설정된 다른 UI 속성에서 제공됩니다. 예를 들어 TextBoxAutomationPeer는 소유자 TextBoxText 속성 값을 기본 이름으로 사용하는 동작을 구현합니다. 사용자 코드 관점에서 다른 AutomationProperties.Name 값을 적용하여 기본 동작을 재정의할 수 있습니다. 피어 구현자/공급자 관점에서 피어의 기본 동작은 기존 피어에서 새 피어 클래스를 파생시키고, GetNameCore를 재정의하고, 적어도 일부 경우에는 기본 구현을 호출하지 않는 새 구현을 제공하여 변경할 수 있습니다.

기본 Windows 런타임 컨트롤에 대한 특정 피어 클래스의 가능한 기본 동작에 대해 자세히 알아보려면 해당 특정 피어 클래스에 대한 참조 항목을 참조하고 주의 섹션에서 구현 정보를 찾습니다.

적용 대상

추가 정보