AutomationProperties 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
자동화 속성의 instance 수준 값을 가져오거나 설정하기 위한 지원을 제공합니다. 이러한 속성 값은 연결된 속성(일반적으로 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 연결 속성에 대한 호스트 서비스 클래스입니다. 이러한 연결된 속성의 목적은 UI 요소가 Microsoft UI 자동화 접근성 프레임워크에 보고되는 방법과 관련된 다양한 instance 값 설정을 사용하도록 설정하는 것입니다. 이는 UI 요소의 클래스 디자인이 Microsoft UI 자동화 통합 또는 피어 구현 동작의 일부로 다른 UI 관련 속성 값을 아직 전달하지 않거나 전달되는 값이 Microsoft UI 자동화에 보고하려는 값이 아닌 경우에 유용합니다.
연결된 속성에 대한 XAML 프로세서 액세스를 지원하고 동등한 get 및 set 작업을 코드에 노출하기 위해 연결된 각 XAML 속성에는 AutomationProperties의 멤버이기도 한 Get 및 Set 접근자 메서드 쌍이 있습니다. 예를 들어 GetName 및 SetName 메서드는 Name 연결된 속성을 사용하여 XAML에서 설정하는 대신 자동화 Name 값을 Microsoft UI Automation에 보고하는 것과 동등한 코드 전용 지원을 지원하고 제공합니다. 또는 종속성 속성 시스템을 사용하여 연결된 속성의 값을 가져오거나 설정할 수 있으며, 기본 값도 Microsoft UI 자동화에 보고합니다. GetValue 또는 SetValue를 호출하여 설정할 종속성 속성 식별자의 인수와 값을 얻거나 설정할 대상 개체에 대한 참조를 전달합니다.
Name 속성
연결된 다양한 속성 중에서 가장 중요한 속성은 Name일 것입니다. 이는 사용자가 접근성 시나리오에서 앱과 상호 작용할 때 보조 기술로 가장 자주 액세스하고 보고하는 Name 속성이기 때문입니다. Name은 UI 요소에 대해 사람이 읽을 수 있는 식별자 역할을 합니다.
다양한 UI 요소에는 다른 요소 속성에 따라 기본 이름 값을 제공할 수 있는 피어 전달이 있습니다. 예를 들어 Button 클래스에 대한 피어 전달은 Button 콘텐츠의 ToString 평가를 전달하고 이 문자열을 기본 이름으로 사용합니다. 기본값을 재정의하거나 사용 가능한 Microsoft UI 자동화 이름이 없는 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 자동화로 고유하게 식별하는 문자열을 가져오거나 설정합니다.
|
| 문화권 | 자동화 요소의 로캘 식별자를 가져오거나 설정합니다(예: "en-US" 또는 영어(미국)의 0x0409).
|
| FullDescription | 요소에 대한 확장 설명 텍스트가 포함된 지역화된 문자열을 가져오거나 설정합니다.
|
| HeadingLevel | UI 자동화 요소의 제목 수준을 가져오거나 설정합니다. |
| HelpText | 요소에 대한 도움말 텍스트를 가져오거나 설정합니다.
|
| IsDataValidForForm | 데이터가 양식에 유효한지 여부를 나타내는 값을 가져오거나 설정합니다. |
| IsDialog | 자동화 요소가 대화 상자 창인지 여부를 나타내는 값을 가져오거나 설정합니다.
|
| IsPeripheral | 자동화 요소가 주변 장치 UI를 나타내는지 여부를 나타내는 값을 가져오거나 설정합니다.
|
| IsRequiredForForm | 폼에서 요소를 입력해야 하는지 여부를 나타내는 값을 가져오거나 설정합니다. |
| ItemStatus | 요소에서 항목의 상태 대한 설명을 가져오거나 설정합니다.
|
| ItemType | 지정된 요소의 형식에 대한 설명을 가져오거나 설정합니다.
|
| LabeledBy | 요소의 텍스트 레이블이 포함된 요소를 가져오거나 설정합니다. |
| LandmarkType | 요소와 연결된 랜드마크 형식 식별자를 가져오거나 설정합니다. |
| Level | 계층 구조 또는 손상된 계층 구조 구조 내 요소의 위치를 설명하는 1 기반 정수 를 가져오거나 설정합니다.
|
| LiveSetting | 지정된 요소의 라이브 설정 값을 가져오거나 설정합니다. |
| LocalizedControlType | Automation 요소가 나타내는 컨트롤의 형식을 설명하는 지역화된 텍스트 문자열을 가져오거나 설정합니다. |
| LocalizedLandmarkType | Automation 요소가 나타내는 랜드마크의 형식을 설명하는 지역화된 텍스트 문자열을 가져오거나 설정합니다. |
| Name | 요소의 UI 자동화 이름을 가져오거나 설정합니다.
|
| PositionInSet | 형제로 간주되는 요소 집합 내에서 요소의 서수 위치를 설명하는 1 기반 정수 를 가져오거나 설정합니다. |
| SizeOfSet | 형제로 간주되는 요소 집합의 요소 수를 가져오거나 설정합니다.
|
속성
| AcceleratorKeyProperty |
Automation 요소에 대한 바로 가기 키(바로 가기 키라고도 함) 조합을 포함하는 문자열인 AutomationProperties.AcceleratorKey 연결된 속성을 식별합니다. |
| AccessibilityViewProperty |
AutomationProperties.AccessibilityView 연결된 속성을 식별합니다. UI 자동화 클라이언트에서 요청한 특정 모드로 요소 표시 유형을 변경하려면 개별 요소에서 이 연결된 속성을 설정합니다. |
| AccessKeyProperty |
Automation 요소에 대한 액세스 키 문자를 포함하는 문자열인 AutomationProperties.AccessKey 연결된 속성을 식별합니다. |
| AnnotationsProperty |
메모, 머리글, 바닥글 등 문서의 주석 개체 목록에 사용되는 종속성 속성을 식별합니다. |
| AutomationControlTypeProperty |
AutomationProperties 연결된 속성()을 식별합니다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 |
Automation 요소를 양식에 입력해야 하는지 여부를 나타내는 부울 값인 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 자동화로 고유하게 식별하는 문자열을 가져오거나 설정합니다. |
| 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 |
자동화 요소가 나타내는 랜드마크의 형식을 설명하는 지역화된 텍스트 문자열을 가져오거나 설정합니다. |
| Name |
요소의 UI 자동화 이름을 가져오거나 설정합니다. |
| PositionInSet |
형제로 간주되는 요소 집합 내에서 요소의 서수 위치를 설명하는 1 기반 정수 를 가져오거나 설정합니다. |
| SizeOfSet |
형제로 간주되는 요소 집합의 요소 수를 가져오거나 설정합니다. |
메서드
적용 대상
추가 정보
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기