AutomationProperties 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
자동화 속성의 인스턴스 수준 값을 가져오거나 설정하기 위한 지원을 제공합니다. 이러한 속성 값은 연결된 속성(일반적으로 XAML)으로 설정되며 컨트롤의 AutomationPeer자동화 속성 값을 보완하거나 재정의합니다.
public ref class AutomationProperties sealed/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 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(Microsoft.UI.Xaml.WinUIContract), 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- 상속
- 특성
설명
XAML 연결된 속성
AutomationProperties는여러
연결된 속성에 대한 XAML 프로세서 액세스를 지원하고 동등한 get 및 set 연산을 코드에 노출하기 위해 각 XAML 연결된 속성에는 AutomationProperties의 멤버인 Get 및 Set 접근자 메서드 쌍이 있습니다. 예를 들어 GetName 및 SetName 메서드는 Name 연결된 속성을 사용하여 XAML에서 설정하는 대신 자동화 Name 값을 Microsoft UI Automation에 보고하기 위한 동등한 코드 전용 지원을 지원합니다. 또는 종속성 속성 시스템을 사용하여 연결된 속성의 값을 가져오거나 설정할 수 있으며, 기본 값도 Microsoft UI Automation에 보고합니다. GetValue 또는 SetValue호출하고 설정할 종속성 속성 식별자의 인수와 값을 얻거나 설정할 대상 개체에 대한 참조를 전달합니다.
Name 속성
연결된 다양한 속성 중에서 가장 중요한 속성은 Name. 이는 사용자가 접근성 시나리오에서 앱과 상호 작용할 때 보조 기술에서 가장 자주 액세스하고 보고하는 Name 속성이기 때문입니다. Name UI 요소에 대해 사람이 읽을 수 있는 식별자 역할을 합니다.
다양한 UI 요소에는 다른 요소 속성에 따라 기본 Name 값을 제공할 수 있는 피어 전달이 있습니다. 예를 들어 Button 클래스에 대한 피어 전달은 단추 콘텐츠의 ToString 평가를 전달하고 이 문자열을 기본 이름사용합니다. 기본값을 재정의하거나 사용 가능한 Microsoft UI Automation Name 없는 UI 요소의 Name 값을 제공하려면 XAML에서 해당 요소에 Name 연결된 속성을 설정합니다. Microsoft UI 자동화 이름 중요한 이유에 대한 자세한 내용은 기본 접근성 정보참조하세요. 요소에 유용한 피어 제공 이름 이미 있는지 여부를 테스트하는 방법에 대한 자세한 내용은 접근성 테스트참조하세요.
지역화를 위해 XAML의 Name 하드 코딩된 문자열 값을 피해야 합니다. 요소에 x:Uid 지시문 설정한 경우 RESW 리소스를 사용하여 속성을 대상으로 지정하고 지역화에 다른 값을 제공할 수 있습니다. 연결된 속성의 경우 리소스 식별자 양식에는 네임스페이스 및 using: 접두사를 포함하여 XAML 형식의 연결된 속성에 대한 전체 정규화가 필요합니다. 예를 들어 x:Uid 지시문 값이 "sendButton"인 리소스에서 AutomationProperties.Name 연결된 속성 값을 대상으로 지정하려면 RESW 리소스에 있는 데이터 항목의 이름 값이 sendButton.[using:Windows.UI.Xaml.Automation]AutomationProperties.Name
연결된 속성
메모
연결된 각 속성에 대한 자세한 내용은 속성의 식별자 필드페이지를 참조하세요.
| 연결된 속성 | 묘사 |
|---|---|
| AcceleratorKey | 지정된 요소의 액셀러레이터 키를 가져오거나 설정합니다. |
| AccessibilityView | 요소에 대한 Microsoft UI 자동화 트리 뷰 모드를 가져오거나 설정합니다. |
| AccessKey | 지정된 요소의 액세스 키를 가져오거나 설정합니다.
|
| AutomationId | 요소를 고유하게 식별하는 문자열을 Microsoft UI Automation으로 가져오거나 설정합니다. |
| 문화 | 자동화 요소의 로캘 식별자(예: "en-US" 또는 영어(미국)의 0x0409)를 가져오거나 설정합니다.
|
| FullDescription | 요소에 대한 확장 설명 텍스트가 포함된 지역화된 문자열을 가져오거나 설정합니다. |
| HeadingLevel | UI 자동화 요소의 제목 수준을 가져오거나 설정합니다. |
| HelpText | 요소의 도움말 텍스트를 가져오거나 설정합니다.
|
| IsDataValidForForm | 데이터가 양식에 유효한지 여부를 나타내는 값을 가져오거나 설정합니다. |
| IsDialog | 자동화 요소가 대화 상자 창인지 여부를 나타내는 값을 가져오거나 설정합니다. |
| IsPeripheral | 자동화 요소가 주변 장치 UI를 나타내는지 여부를 나타내는 값을 가져오거나 설정합니다. |
| IsRequiredForForm | 폼에서 요소를 작성해야 하는지 여부를 나타내는 값을 가져오거나 설정합니다. |
| ItemStatus | 요소의 항목 상태에 대한 설명을 가져오거나 설정합니다. |
| ItemType | 지정된 요소의 형식에 대한 설명을 가져오거나 설정합니다.
|
| LabeledBy | 요소의 텍스트 레이블을 포함하는 요소를 가져오거나 설정합니다. |
| LandmarkType | 요소와 연결된 랜드마크 형식 식별자 가져오거나 설정합니다. |
| 수준 | 계층 구조 또는 끊어진 계층 구조 내 요소의 위치를 설명하는 1부터 시작하는 정수를 가져오거나 설정합니다.
|
| LiveSetting | 지정된 요소의 라이브 설정 값을 가져오거나 설정합니다. |
| LocalizedControlType | 자동화 요소가 나타내는 컨트롤의 형식을 설명하는 지역화된 텍스트 문자열을 가져오거나 설정합니다. |
| LocalizedLandmarkType | Automation 요소가 나타내는 랜드마크의 형식을 설명하는 지역화된 텍스트 문자열을 가져오거나 설정합니다. |
| 이름 | 요소의 UI 자동화 이름을 가져오거나 설정합니다.
|
| PositionInSet | 형제로 간주되는 요소 집합 내에서 요소의 서수 위치를 설명하는 1부터 시작하는 정수를 가져오거나 설정합니다. |
| SizeOfSet | 형제로 간주되는 요소 집합의 요소 수를 가져오거나 설정합니다.
|
속성
| AcceleratorKeyProperty |
Automation 요소에 대한 액셀러레이터 키(바로 가기 키라고도 함) 조합이 포함된 문자열인 AutomationProperties.AcceleratorKey 연결된 속성을 |
| AccessibilityViewProperty |
AutomationProperties.AccessibilityView 연결된 속성을 |
| AccessKeyProperty |
Automation 요소에 대한 액세스 키 문자를 포함하는 문자열인 automationProperties.AccessKey 연결된 속성을 |
| AnnotationsProperty |
메모, 머리글, 바닥글 등 문서의 주석 개체 목록에 사용되는 종속성 속성을 식별합니다. |
| AutomationControlTypeProperty |
Microsoft.UI.Xaml.Automation.Peers.AutomationControlType |
| AutomationIdProperty |
Automation 요소에 대한 UI 자동화 식별자(ID)가 포함된 문자열인 automationProperties.AutomationId 연결된 속성을 |
| ControlledPeersProperty |
지정된 자동화 요소에서 조작할 수 있는 자동화 요소 컬렉션에 사용되는 ControlledPeers 연결된 속성을 식별합니다. |
| CultureProperty |
자동화 요소에 대한 로캘 식별자를 포함하는 문화권 연결된 속성의 식별자를 가져옵니다(예: "en-US" 또는 영어(미국)의 0x0409). |
| DescribedByProperty |
자동화 요소에 대한 자세한 정보를 제공하는 요소의 배열인 연결된 속성에 설명된 식별자를 가져옵니다. |
| FlowsFromProperty |
현재 자동화 요소 앞에 읽기 순서를 제안하는 자동화 요소 배열인 FlowsFrom 연결된 속성의 식별자를 가져옵니다. |
| FlowsToProperty |
현재 자동화 요소 뒤의 읽기 순서를 제안하는 자동화 요소 배열인 FlowsTo 연결된 속성의 식별자를 가져옵니다. |
| FullDescriptionProperty |
요소에 대한 확장 설명 텍스트가 포함된 지역화된 문자열을 노출하는 전체 설명 연결된 속성의 식별자를 가져옵니다. |
| HeadingLevelProperty |
UI 자동화 요소의 제목 수준을 나타내는 HeadingLevel 연결된 속성의 식별자를 가져옵니다. |
| HelpTextProperty |
Automation 요소와 연결된 도움말 텍스트 문자열인 AutomationProperties.HelpText 연결된 속성을 식별합니다. |
| IsDataValidForFormProperty |
데이터가 양식에 유효한지 여부를 나타내는 부울 종속성 속성을 식별합니다. |
| IsDialogProperty |
automation 요소가 대화 상자 창인지 여부를 나타내는 부울 값인 AutomationProperties.IsDialog 연결된 속성을 식별합니다. |
| IsPeripheralProperty |
자동화 요소가 주변 장치 UI를 나타내는지 여부를 나타내는 부울 종속성 속성을 식별합니다. |
| IsRequiredForFormProperty |
AutomationProperties.IsRequiredForForm 연결된 속성을 |
| ItemStatusProperty |
Automation 요소 항목의 상태를 설명하는 ItemStatus 연결된 속성을 식별합니다. |
| ItemTypeProperty |
automation 요소의 형식을 설명하는 텍스트 문자열인 AutomationProperties.ItemType 연결된 속성을 식별합니다. |
| LabeledByProperty |
AutomationProperties.LabeledBy 연결된 속성을 |
| LandmarkTypeProperty |
요소와 연결된 랜드마크 형식 식별자 연결된 랜드마크 형식 연결 속성의 식별자를 가져옵니다. |
| LevelProperty |
automation 요소와 연결된 1부터 시작하는 정수인 Level 연결된 속성의 식별자를 가져옵니다. |
| LiveSettingProperty |
라이브 지역을 나타내는 Automation 요소에서 지원하는 AutomationProperties.LiveSetting 연결된 속성을 식별합니다. |
| LocalizedControlTypeProperty |
자동화 요소가 나타내는 컨트롤의 형식을 설명하는 텍스트 문자열인 지역화된 컨트롤 형식 종속성 속성을 식별합니다. |
| LocalizedLandmarkTypeProperty |
자동화 요소가 나타내는 랜드마크의 형식을 설명하는 지역화된 텍스트 문자열인 지역화된 랜드마크 형식 연결 속성의 식별자를 가져옵니다. |
| NameProperty |
automation 요소의 이름을 포함하는 문자열인 AutomationProperties.Name 연결된 속성을 식별합니다. |
| PositionInSetProperty |
automation 요소와 연결된 1부터 시작하는 정수인 PositionInSet 연결된 속성의 식별자를 가져옵니다. |
| SizeOfSetProperty |
연결된 속성의 식별자를 가져옵니다. |
연결된 속성
| AcceleratorKey |
자동화 요소에 대한 바로 가기 키(바로 가기 키라고도 함) 조합이 포함된 문자열을 가져오거나 설정합니다. |
| AccessibilityView |
요소에 대한 Microsoft UI 자동화 트리 뷰 모드를 가져오거나 설정합니다. |
| AccessKey |
Automation 요소에 대한 액세스 키 문자가 포함된 문자열을 가져오거나 설정합니다. |
| Annotations |
메모, 머리글, 바닥글 등 문서의 주석 개체 목록을 가져옵니다. |
| AutomationControlType |
Microsoft UI 자동화 클라이언트에 노출되는 UI(사용자 인터페이스) 요소의 유형을 식별합니다. |
| AutomationId |
요소를 고유하게 식별하는 문자열을 Microsoft UI Automation으로 가져오거나 설정합니다. |
| ControlledPeers |
지정된 자동화 요소에서 조작할 수 있는 자동화 요소의 컬렉션을 가져옵니다. |
| Culture |
자동화 요소의 로캘 식별자(예: "en-US" 또는 영어(미국)의 0x0409)를 가져오거나 설정합니다. |
| DescribedBy |
자동화 요소에 대한 자세한 정보를 제공하는 요소의 배열을 가져옵니다. |
| FlowsFrom |
현재 자동화 요소 앞의 읽기 순서를 제안하는 자동화 요소의 배열을 가져옵니다. |
| FlowsTo |
현재 자동화 요소 뒤의 읽기 순서를 제안하는 자동화 요소의 배열을 가져옵니다. |
| FullDescription |
요소에 대한 확장 설명 텍스트가 포함된 지역화된 문자열을 가져오거나 설정합니다. |
| HeadingLevel |
UI 자동화 요소의 제목 수준을 가져오거나 설정합니다. |
| HelpText |
Automation 요소와 연결된 도움말 텍스트 문자열을 가져오거나 설정합니다. |
| IsDataValidForForm |
데이터가 양식에 유효한지 여부를 나타내는 값을 가져오거나 설정합니다. |
| IsDialog |
자동화 요소가 대화 상자 창인지 여부를 나타내는 값을 가져오거나 설정합니다. |
| IsPeripheral |
자동화 요소가 주변 장치 UI를 나타내는지 여부를 나타내는 값을 가져오거나 설정합니다. |
| IsRequiredForForm |
폼에서 요소를 작성해야 하는지 여부를 나타내는 값을 가져오거나 설정합니다. |
| ItemStatus |
요소의 항목 상태에 대한 설명을 가져오거나 설정합니다. |
| ItemType |
지정된 요소의 형식에 대한 설명을 가져오거나 설정합니다. |
| LabeledBy |
이 요소의 텍스트 레이블을 포함하는 자동화 요소를 가져오거나 설정합니다. |
| LandmarkType |
요소와 연결된 랜드마크 형식 식별자 가져오거나 설정합니다. |
| Level |
계층 구조 또는 끊어진 계층 구조 내 요소의 위치를 설명하는 1부터 시작하는 정수를 가져오거나 설정합니다. |
| LiveSetting |
라이브 영역을 나타내는 자동화 요소에서 지원하는 지정된 요소의 라이브 설정 값을 가져오거나 설정합니다. |
| LocalizedControlType |
자동화 요소가 나타내는 컨트롤의 형식을 설명하는 지역화된 텍스트 문자열을 가져오거나 설정합니다. |
| LocalizedLandmarkType |
Automation 요소가 나타내는 랜드마크의 형식을 설명하는 지역화된 텍스트 문자열을 가져오거나 설정합니다. |
| Name |
요소의 UI 자동화 이름을 가져오거나 설정합니다. |
| PositionInSet |
형제로 간주되는 요소 집합 내에서 요소의 서수 위치를 설명하는 1부터 시작하는 정수를 가져오거나 설정합니다. |
| SizeOfSet |
형제로 간주되는 요소 집합의 요소 수를 가져오거나 설정합니다. |
메서드
적용 대상
추가 정보
- 접근성
- 기본 접근성 정보
- 접근성 테스트
- 연결된 속성 개요
- Windows 데스크톱 앱의 일반적인 프로그래밍 방식 접근성 문제를 해결하기 위한 코드 샘플