다음을 통해 공유


AutomationProperties 클래스

정의

자동화 속성의 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 AutomationProperties
Public NotInheritable Class AutomationProperties
상속
Object Platform::Object IInspectable 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의 멤버이기도 한 GetSet 접근자 메서드 쌍이 있습니다. 예를 들어 GetNameSetName 메서드는 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

속성

AcceleratorKeyProperty

AutomationProperties.AcceleratorKey 연결된 속성을 식별합니다.

AccessibilityViewProperty

AutomationProperties.AccessibilityView 연결된 속성을 식별합니다.

AccessKeyProperty

AutomationProperties.AccessKey 연결된 속성을 식별합니다.

AnnotationsProperty

AutomationProperties.Annotations 연결된 속성을 식별합니다.

AutomationControlTypeProperty

AutomationProperties.AutomationControlType 연결된 속성을 식별합니다.

AutomationIdProperty

AutomationProperties.AutomationId 연결된 속성을 식별합니다.

ControlledPeersProperty

AutomationProperties.ControlledPeers 연결된 속성을 식별합니다.

CultureProperty

AutomationProperties.Culture 연결된 속성을 식별합니다.

DescribedByProperty

AutomationProperties.DescribedBy 연결된 속성을 식별합니다.

FlowsFromProperty

FlowsFrom 연결된 속성을 식별합니다.

FlowsToProperty

FlowsTo 연결 속성을 식별합니다.

FullDescriptionProperty

AutomationProperties.FullDescription XAML 연결된 속성을 식별합니다.

HeadingLevelProperty

HeadingLevel XAML 연결된 속성을 식별합니다.

HelpTextProperty

AutomationProperties.HelpText XAML 연결된 속성을 식별합니다.

IsDataValidForFormProperty

AutomationProperties.IsDataValidForForm XAML 연결된 속성을 식별합니다.

IsDialogProperty

AutomationProperties.IsDialog XAML 연결된 속성을 식별합니다.

IsPeripheralProperty

AutomationProperties.IsPeripheral XAML 연결된 속성을 식별합니다.

IsRequiredForFormProperty

AutomationProperties.IsRequiredForForm XAML 연결된 속성을 식별합니다.

ItemStatusProperty

AutomationProperties.ItemStatus XAML 연결된 속성을 식별합니다.

ItemTypeProperty

AutomationProperties.ItemType XAML 연결된 속성을 식별합니다.

LabeledByProperty

AutomationProperties.LabeledBy XAML 연결된 속성을 식별합니다.

LandmarkTypeProperty

AutomationProperties.LandmarkType XAML 연결된 속성을 식별합니다.

LevelProperty

AutomationProperties.Level XAML 연결된 속성을 식별합니다.

LiveSettingProperty

AutomationProperties.LiveSetting XAML 연결된 속성을 식별합니다.

LocalizedControlTypeProperty

Automation 요소가 나타내는 컨트롤의 형식을 설명하는 텍스트 문자열인 AutomationProperties.LocalizedControlType XAML 연결 속성을 식별합니다.

LocalizedLandmarkTypeProperty

AutomationProperties.LocalizedLandmarkType XAML 연결된 속성을 식별합니다.

NameProperty

AutomationProperties.Name XAML 연결 속성을 식별합니다.

PositionInSetProperty

AutomationProperties.PositionInSet XAML 연결된 속성을 식별합니다.

SizeOfSetProperty

AutomationProperties.SizeOfSet XAML 연결된 속성을 식별합니다.

연결된 속성

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

형제로 간주되는 요소 집합의 요소 수를 가져오거나 설정합니다.

메서드

GetAcceleratorKey(DependencyObject)

지정된 DependencyObject에 대한 AutomationProperties.AcceleratorKey 연결된 속성의 값을 가져옵니다.

GetAccessibilityView(DependencyObject)

지정된 DependencyObject에 대한 AutomationProperties.AccessibilityView 연결된 속성의 값을 가져옵니다.

GetAccessKey(DependencyObject)

지정된 DependencyObject에 대한 AutomationProperties.AccessKey 연결된 속성의 값을 가져옵니다.

GetAnnotations(DependencyObject)

지정된 DependencyObject에 대한 AutomationProperties.Annotations 속성의 값을 가져옵니다.

GetAutomationControlType(UIElement)

지정된 DependencyObject에 대한 AutomationProperties.AutomationControlType 연결된 속성의 값을 가져옵니다.

GetAutomationId(DependencyObject)

지정된 DependencyObject에 대한 AutomationProperties.AutomationId 연결된 속성의 값을 가져옵니다.

GetControlledPeers(DependencyObject)

대상 소유자로부터 제어된 피어 목록을 검색하는 정적 유틸리티 메서드입니다.

GetCulture(DependencyObject)

지정된 DependencyObject에 대한 Culture XAML 연결된 속성의 값을 가져옵니다.

GetDescribedBy(DependencyObject)

지정된 자동화 요소에 대한 자세한 정보를 제공하는 요소의 컬렉션을 가져옵니다.

GetFlowsFrom(DependencyObject)

지정된 자동화 요소 앞의 읽기 순서를 제안하는 자동화 요소 목록을 가져옵니다.

GetFlowsTo(DependencyObject)

지정된 자동화 요소 다음에 읽기 순서를 제안하는 자동화 요소 목록을 가져옵니다.

GetFullDescription(DependencyObject)

지정된 DependencyObject에 대한 AutomationProperties.FullDescription 속성의 값을 가져옵니다.

GetHeadingLevel(DependencyObject)

지정된 DependencyObject에 대한 AutomationProperties.HeadingLevel 속성의 값을 가져옵니다.

GetHelpText(DependencyObject)

지정한 DependencyObject에 대한 AutomationProperties.HelpText 연결된 속성의 값을 가져옵니다.

GetIsDataValidForForm(DependencyObject)

지정한 DependencyObject에 대한 AutomationProperties.IsDataValidForForm 속성의 값을 가져옵니다.

GetIsDialog(DependencyObject)

지정된 DependencyObject에 대한 AutomationProperties.IsDialog 연결된 속성의 값을 가져옵니다.

GetIsPeripheral(DependencyObject)

지정된 요소가 주변 UI를 나타내는지 여부를 나타내는 부울 값을 가져옵니다.

GetIsRequiredForForm(DependencyObject)

지정된 DependencyObject에 대한 AutomationProperties.IsRequiredForForm 연결된 속성의 값을 가져옵니다.

GetItemStatus(DependencyObject)

지정한 DependencyObject에 대한 AutomationProperties.ItemStatus 연결된 속성의 값을 가져옵니다.

GetItemType(DependencyObject)

지정된 DependencyObject에 대한 AutomationProperties.ItemType 연결된 속성의 값을 가져옵니다.

GetLabeledBy(DependencyObject)

지정된 DependencyObject에 대한 AutomationProperties.LabeledBy 연결된 속성의 값을 가져옵니다.

GetLandmarkType(DependencyObject)

지정된 DependencyObject에 대한 연결된 랜드마크 형식 속성의 값을 가져옵니다.

GetLevel(DependencyObject)

지정된 요소에 대한 AutomationProperties.Level 속성의 값을 가져옵니다.

GetLiveSetting(DependencyObject)

지정된 DependencyObject에 대한 AutomationProperties.LiveSetting 연결된 속성의 값을 가져옵니다.

GetLocalizedControlType(DependencyObject)

지정된 컨트롤의 형식을 나타내는 지역화된 문자열을 가져옵니다.

GetLocalizedLandmarkType(DependencyObject)

지정된 DependencyObject에 대해 지역화된 랜드마크 형식 연결된 속성의 값을 가져옵니다.

GetName(DependencyObject)

지정된 DependencyObject에 대한 AutomationProperties.Name 연결된 속성의 값을 가져옵니다.

GetPositionInSet(DependencyObject)

지정된 DependencyObject에 대한 AutomationProperties.PositionInSet 속성의 값을 가져옵니다.

GetSizeOfSet(DependencyObject)

지정된 DependencyObject에 대한 AutomationProperties.SizeOfSet 속성의 값을 가져옵니다.

SetAcceleratorKey(DependencyObject, String)

지정한 DependencyObject에 대한 AutomationProperties.AcceleratorKey 연결된 속성의 값을 설정합니다.

SetAccessibilityView(DependencyObject, AccessibilityView)

지정한 DependencyObject에 대한 AutomationProperties.AccessibilityView 연결된 속성의 값을 설정합니다.

SetAccessKey(DependencyObject, String)

지정한 DependencyObject에 대한 AutomationProperties.AccessKey 연결된 속성의 값을 설정합니다.

SetAutomationControlType(UIElement, AutomationControlType)

지정한 DependencyObject에 대한 AutomationProperties.AutomationControlType 연결된 속성의 값을 설정합니다.

SetAutomationId(DependencyObject, String)

지정된 DependencyObject에 대한 AutomationProperties.AutomationId 연결된 속성의 값을 설정합니다.

SetCulture(DependencyObject, Int32)

지정된 DependencyObject에 대한 Culture 연결된 속성의 값을 설정합니다.

SetFullDescription(DependencyObject, String)

지정된 DependencyObject의 시각적 모양 또는 내용을 설명하는 지역화된 문자열을 설정합니다.

SetHeadingLevel(DependencyObject, AutomationHeadingLevel)

지정된 DependencyObject에 대한 AutomationProperties.HeadingLevel 속성의 값을 설정합니다.

SetHelpText(DependencyObject, String)

지정된 DependencyObject에 대한 AutomationProperties.HelpText 연결된 속성의 값을 설정합니다.

SetIsDataValidForForm(DependencyObject, Boolean)

입력한 값 또는 선택한 값이 지정된 요소와 연결된 양식 규칙에 유효한지 여부를 나타내는 부울 값을 설정합니다.

SetIsDialog(DependencyObject, Boolean)

지정된 요소를 대화 상자 창으로 식별해야 하는지 여부를 나타내는 부울 값을 설정합니다.

SetIsPeripheral(DependencyObject, Boolean)

지정된 요소가 주변 장치 UI를 나타내는지 여부를 나타내는 부울 값을 설정합니다.

SetIsRequiredForForm(DependencyObject, Boolean)

지정한 DependencyObject에 대한 AutomationProperties.IsRequiredForForm 연결된 속성의 값을 설정합니다.

SetItemStatus(DependencyObject, String)

지정된 DependencyObject에 대한 AutomationProperties.ItemStatus 연결된 속성의 값을 설정합니다.

SetItemType(DependencyObject, String)

지정된 DependencyObject에 대한 AutomationProperties.ItemType 연결된 속성의 값을 설정합니다.

SetLabeledBy(DependencyObject, UIElement)

지정된 DependencyObject에 대한 AutomationProperties.LabeledBy 연결된 속성의 값을 설정합니다.

SetLandmarkType(DependencyObject, AutomationLandmarkType)

지정된 DependencyObject에 연결된 랜드마크 형식 속성의 값을 설정합니다.

SetLevel(DependencyObject, Int32)

지정된 DependencyObject에 대한 AutomationProperties.Level 연결된 속성의 값을 설정합니다.

SetLiveSetting(DependencyObject, AutomationLiveSetting)

지정된 DependencyObject에 대한 AutomationProperties.LiveSetting 연결된 속성의 값을 설정합니다.

SetLocalizedControlType(DependencyObject, String)

지정된 컨트롤의 형식을 나타내는 지역화된 문자열을 설정합니다.

SetLocalizedLandmarkType(DependencyObject, String)

지정된 DependencyObject에 대해 지역화된 랜드마크 형식 연결된 속성의 값을 설정합니다.

SetName(DependencyObject, String)

지정된 DependencyObject에 대한 AutomationProperties.Name 연결된 속성의 값을 설정합니다.

SetPositionInSet(DependencyObject, Int32)

지정된 DependencyObject에 대한 AutomationProperties.PositionInSet 연결된 속성의 값을 설정합니다.

SetSizeOfSet(DependencyObject, Int32)

지정된 DependencyObject에 대한 AutomationProperties.SizeOfSet 연결된 속성의 값을 설정합니다.

적용 대상

추가 정보