AutomationProperties 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
자동화 속성의 instance 수준 값을 가져오거나 설정하기 위한 지원을 제공합니다. 이러한 속성 값은 연결된 속성(일반적으로 XAML)으로 설정되며 컨트롤의 AutomationPeer에서 자동화 속성 값을 보완하거나 재정의합니다.
public ref class AutomationProperties sealed/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class AutomationProperties final[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class AutomationPropertiesPublic NotInheritable Class AutomationProperties- 상속
- 특성
Windows 요구 사항
| 디바이스 패밀리 |
Windows 10 (10.0.10240.0에서 도입되었습니다.)
|
| API contract |
Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)
|
예제
팁
WinUI 3 갤러리 앱을 열고 다음 접근성 원칙이 작동하는 것을 확인합니다.
WinUI 3 갤러리 앱에는 대부분의 WinUI 3 컨트롤, 기능 및 기능에 대한 대화형 예제가 포함되어 있습니다. Microsoft Store에서 앱을 가져오거나 GitHub에서 소스 코드를 가져옵니다.
설명
AutomationProperties는 여러 XAML 연결 속성에 대한 호스트 서비스 클래스입니다. 이러한 연결된 속성의 목적은 UI 요소가 Microsoft UI 자동화 접근성 프레임워크에 보고되는 방법과 관련이 있는 다양한 instance 값 설정을 사용하도록 설정하는 것입니다. 이는 UI 요소의 클래스 디자인이 Microsoft UI 자동화 통합 또는 피어 구현 동작의 일부로 다른 UI 관련 속성 값을 전달하지 않거나 전달되는 값이 Microsoft UI 자동화 보고하려는 값이 아닌 경우에 유용합니다.
연결된 속성에 대한 XAML 프로세서 액세스를 지원하고 동등한 get 및 set 작업을 코드에 노출하기 위해 연결된 각 XAML 속성에는 AutomationProperties의 멤버이기도 한 Get 및 Set 접근자 메서드 쌍이 있습니다. 예를 들어 GetName 및 SetName 메서드는 Name 연결된 속성을 사용하여 XAML에서 설정하는 대신 자동화 Name 값을 Microsoft UI 자동화 보고하기 위한 동등한 코드 전용 지원을 지원하고 제공합니다. 또는 종속성 속성 시스템을 사용하여 연결된 속성의 값을 가져오거나 설정할 수 있으며, 기본 값도 Microsoft UI 자동화 보고합니다. GetValue 또는 SetValue를 호출하여 설정할 종속성 속성 식별자의 인수와 값을 얻거나 설정할 대상 개체에 대한 참조를 전달합니다.
Name 속성
연결된 다양한 속성 중에서 가장 중요한 속성은 Name일 것입니다. 이는 사용자가 접근성 시나리오에서 앱과 상호 작용할 때 보조 기술로 가장 자주 액세스하고 보고하는 Name 속성이기 때문입니다. Name은 UI 요소에 대해 사람이 읽을 수 있는 식별자 역할을 합니다.
다양한 UI 요소에는 다른 요소 속성에 따라 기본 이름 값을 제공할 수 있는 피어 전달이 있습니다. 예를 들어 Button 클래스의 피어 전달은 Button 콘텐츠의 ToString 평가를 전달하고 이 문자열을 기본 이름으로 사용합니다. 기본값을 재정의하거나 사용 가능한 Microsoft UI 자동화 Name이 없는 UI 요소의 Name 값을 제공하려면 XAML에서 해당 요소에 연결된 Name 속성을 설정합니다. Microsoft UI 자동화 Name이 중요한 이유에 대한 자세한 내용은 기본 접근성 정보를 참조하세요. 요소에 이미 유용한 피어 제공 이름이 있는지 여부를 테스트하는 방법에 대한 자세한 내용은 접근성 테스트를 참조하세요.
지역화를 위해 XAML의 Name 에 대해 하드 코딩된 문자열 값을 피해야 합니다. 요소에 x:Uid 지시문을 설정하는 경우 RESW 리소스를 사용하여 속성을 대상으로 지정하고 지역화에 다른 값을 제공할 수 있습니다. 연결된 속성의 경우 리소스 식별자 양식에는 네임스페이스 및 using: 접두사를 포함하여 XAML 형식의 연결된 속성에 대한 전체 정규화가 필요합니다. 예를 들어 x:Uid 지시문 값이 "sendButton"인 리소스에서 AutomationProperties.Name 연결된 속성 값을 대상으로 지정하려면 RESW 리소스에 있는 데이터 항목의 이름 값은 입니다.sendButton.[using:Windows.UI.Xaml.Automation]AutomationProperties.Name
전체 목록은 연결된 속성을 참조하세요(연결된 각 속성에 대한 자세한 내용은 각 속성의 식별자 필드를 참조하세요).
버전 기록
| Windows 버전 | SDK 버전 | 추가된 값 |
|---|---|---|
| 1511 | 10586 | GetLandmarkType |
| 1511 | 10586 | GetLocalizedLandmarkType |
| 1511 | 10586 | SetLandmarkType |
| 1511 | 10586 | SetLocalizedLandmarkType |
| 1607 | 14393 | GetDescribedBy |
| 1607 | 14393 | GetFlowsFrom |
| 1607 | 14393 | GetFlowsTo |
| 1607 | 14393 | GetFullDescription |
| 1607 | 14393 | GetIsDataValidForForm |
| 1607 | 14393 | GetIsPeripheral |
| 1607 | 14393 | GetLocalizedControlType |
| 1607 | 14393 | SetFullDescription |
| 1607 | 14393 | SetIsDataValidForForm |
| 1607 | 14393 | SetIsPeripheral |
| 1607 | 14393 | SetLocalizedControlType |
| 1703 | 15063 | GetCulture |
| 1703 | 15063 | SetCulture |
| 1803 | 17134 | GetHeadingLevel |
| 1803 | 17134 | SetHeadingLevel |
| 1809 | 17763 | GetIsDialog |
| 1809 | 17763 | SetIsDialog |
속성
연결된 속성
| AcceleratorKey |
자동화 요소에 대한 가속기 키(바로 가기 키라고도 함) 조합이 포함된 문자열을 가져오거나 설정합니다. |
| AccessibilityView |
요소에 대한 Microsoft UI 자동화 트리 뷰 모드를 가져오거나 설정합니다. |
| AccessKey |
automation 요소에 대한 액세스 키 문자가 포함된 문자열을 가져오거나 설정합니다. |
| Annotations |
메모, 머리글, 바닥글 등 문서의 주석 개체 목록을 가져옵니다. |
| AutomationControlType |
Microsoft UI 자동화 대한 컨트롤 형식을 가져오거나 설정합니다. |
| AutomationId |
요소를 고유하게 식별하는 문자열을 Microsoft UI 자동화 가져오거나 설정합니다. |
| ControlledPeers |
지정된 자동화 요소에서 조작할 수 있는 자동화 요소의 컬렉션을 가져옵니다. |
| Culture |
자동화 요소의 로캘 식별자를 가져오거나 설정합니다(예: "en-US" 또는 영어(미국)의 0x0409). |
| DescribedBy |
자동화 요소에 대한 자세한 정보를 제공하는 요소의 배열을 가져옵니다. |
| FlowsFrom |
현재 자동화 요소 앞의 읽기 순서를 제안하는 자동화 요소의 배열을 가져옵니다. |
| FlowsTo |
현재 자동화 요소 뒤의 읽기 순서를 제안하는 자동화 요소의 배열을 가져옵니다. |
| FullDescription |
요소에 대한 확장 설명 텍스트를 포함하는 지역화된 문자열을 가져오거나 설정합니다. |
| HeadingLevel |
UI 자동화 요소의 제목 수준을 가져오거나 설정합니다. |
| HelpText |
Automation 요소와 연결된 도움말 텍스트 문자열을 가져오거나 설정합니다. |
| IsDataValidForForm |
데이터가 양식에 유효한지 여부를 나타내는 값을 가져오거나 설정합니다. |
| IsDialog |
자동화 요소가 대화 상자 창인지 여부를 나타내는 값을 가져오거나 설정합니다. |
| IsPeripheral |
자동화 요소가 주변 장치 UI를 나타내는지 여부를 나타내는 값을 가져오거나 설정합니다. |
| IsRequiredForForm |
폼에서 요소를 입력해야 하는지 여부를 나타내는 값을 가져오거나 설정합니다. |
| ItemStatus |
요소에서 항목의 상태 대한 설명을 가져오거나 설정합니다. |
| ItemType |
지정된 요소의 형식에 대한 설명을 가져오거나 설정합니다. |
| LabeledBy |
이 요소의 텍스트 레이블을 포함하는 Automation 요소를 가져오거나 설정합니다. |
| LandmarkType |
요소와 연결된 랜드마크 형식 식별자를 가져오거나 설정합니다. |
| Level |
계층 구조 또는 손상된 계층 구조 구조 내 요소의 위치를 설명하는 1 기반 정수 를 가져오거나 설정합니다. |
| LiveSetting |
라이브 지역을 나타내는 자동화 요소에서 지원하는 지정된 요소의 라이브 설정 값을 가져오거나 설정합니다. |
| LocalizedControlType |
Automation 요소가 나타내는 컨트롤의 형식을 설명하는 지역화된 텍스트 문자열을 가져오거나 설정합니다. |
| LocalizedLandmarkType |
Automation 요소가 나타내는 랜드마크의 형식을 설명하는 지역화된 텍스트 문자열을 가져오거나 설정합니다. |
| Name |
요소의 UI 자동화 이름을 가져오거나 설정합니다. |
| PositionInSet |
형제로 간주되는 요소 집합 내에서 요소의 서수 위치를 설명하는 1 기반 정수 를 가져오거나 설정합니다. |
| SizeOfSet |
형제로 간주되는 요소 집합의 요소 수를 가져오거나 설정합니다. |