AutomationProperties.Name 연결된 속성

  • 참조

정의

네임스페이스:
Microsoft.UI.Xaml.Automation
편집

요소의 UI 자동화 이름을 가져오거나 설정합니다.

see GetName, and SetName
see GetName, and SetName
see GetName, and SetName

설명

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

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

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

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

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

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

연결된 다양한 속성 중에서 가장 중요한 속성은 입니다 Name. 이는 사용자가 접근성 시나리오에서 Name 앱과 상호 작용할 때 보조 기술로 가장 자주 액세스하고 보고하는 속성이기 때문입니다. 는 Name UI 요소에 대해 사람이 읽을 수 있는 식별자 역할을 합니다.

다양한 UI 요소에는 다른 요소 속성에 따라 기본 Name 값을 제공할 수 있는 피어 전달이 있습니다. 예를 들어 Button 클래스의 피어 전달은 Button 콘텐츠의 평가를 전달 ToString 하고 이 문자열을 기본 Name으로 사용합니다. 기본값을 재정의하거나 사용 가능한 Microsoft UI 자동화 Name 없는 UI 요소 사례에 대한 값을 제공 Name 하려면 XAML에서 해당 요소에 연결된 속성을 설정합니다Name. Microsoft UI 자동화 Name 중요한 이유에 대한 자세한 내용은 기본 접근성 정보를 참조하세요. 요소에 이미 유용한 피어 제공 Name 이 있는지 여부를 테스트하는 방법에 대한 자세한 내용은 접근성 테스트를 참조하세요.

지역화를 위해 XAML에서 에 대한 Name 하드 코딩된 문자열 값을 피해야 합니다. 요소에 x:Uid 지시문을 설정하는 경우 RESW 리소스를 사용하여 속성을 대상으로 지정하고 지역화에 다른 값을 제공할 수 있습니다. 연결된 속성의 경우 리소스 식별자 양식에는 네임스페이스 및 using: 접두사를 포함하여 XAML 형식의 연결된 속성에 대한 전체 정규화가 필요합니다. 예를 들어 x:Uid 지시문 값이 "sendButton"Name인 리소스의 연결된 속성 값을 대상으로 지정 AutomationProperties.Name 하려면 RESW 리소스의 데이터 항목 값은 입니다.sendButton.[using:Windows.UI.Xaml.Automation]AutomationProperties.Name

적용 대상

추가 정보