AutomationProperties.NameProperty 속성

정의

네임스페이스:

Microsoft.UI.Xaml.Automation

automation 요소의 이름을 포함하는 문자열인 연결된 AutomationProperties.Name 속성을 식별합니다.

public:
 static property DependencyProperty ^ NameProperty { DependencyProperty ^ get(); };

static DependencyProperty NameProperty();

public static DependencyProperty NameProperty { get; }

var dependencyProperty = AutomationProperties.nameProperty;

Public Shared ReadOnly Property NameProperty As DependencyProperty

속성 값

DependencyProperty

AutomationProperties.Name 연결된 속성의 식별자입니다.

설명

Name 속성은 화면의 레이블 텍스트와 동일해야 합니다. 예를 들어 이름은 "찾아보기" 레이블이 있는 단추 요소에 대해 "찾아보기"여야 합니다. Name 속성에는 UI 텍스트 프레젠테이션에 밑줄이 그어져 있는 액세스 키(즉, "&")에 대한 니모닉 문자가 포함되어서는 안 됩니다. 또한 Name 속성은 이름과 레이블 간의 불일치로 인해 클라이언트 애플리케이션과 사용자 간에 혼동을 일으킬 수 있으므로 화면 레이블의 확장되거나 수정된 버전이 아니어야 합니다.

해당 레이블 텍스트가 화면에 표시되지 않거나 그래픽으로 바뀐 경우 대체 텍스트를 선택해야 합니다. 대체 텍스트는 간결하고 직관적이며 애플리케이션 UI 언어 또는 운영 체제 기본 UI 언어로 지역화되어야 합니다. 대체 텍스트는 시각적 세부 정보에 대한 자세한 설명이 아니라 간단한 텍스트로 레이블이 지정된 것처럼 UI 함수 또는 기능에 대한 간결한 설명이어야 합니다. 예를 들어 Windows 시작 메뉴 단추의 이름은 "파란색 둥근 구 그래픽의 Windows 로고"(단추) 대신 "시작"(단추)입니다. 자세한 내용은 이미지에 해당하는 텍스트 만들기를 참조하세요.

UI 레이블이 텍스트 그래픽을 사용하는 경우(예: 왼쪽에서 오른쪽으로 항목을 추가하는 단추에 ">>"사용) Name 속성은 적절한 텍스트 대안(예: "추가")으로 재정의되어야 합니다. 그러나 지역화 및 접근성 문제로 인해 텍스트 그래픽을 UI 레이블로 사용하는 방법은 권장되지 않습니다.

Name 속성에는 "button" 또는 "list"와 같은 컨트롤 역할 또는 형식 정보가 포함되어서는 안 됩니다. 그렇지 않으면 이러한 두 속성이 추가될 때 LocalizedControlType 속성의 텍스트와 충돌합니다(많은 기존 보조 기술에서 이 작업을 수행).

Name 속성은 형제 간 고유 식별자로 사용할 수 없습니다. 그러나 UI 프레젠테이션과 일치하는 한 피어 간에 동일한 Name 값을 지원합니다. 테스트 자동화의 경우 클라이언트는 AutomationId 또는 RuntimeId 속성을 사용하는 것이 좋습니다.

텍스트 패턴도 지원되는 한 텍스트 컨트롤에 Name 속성이 컨트롤 내에 표시되는 텍스트와 항상 동일할 필요는 없습니다.