AutomationElementIdentifiers 클래스

정의

네임스페이스:

Windows.UI.Xaml.Automation

UI 자동화 공급자 및 UI 자동화 클라이언트에서 자동화 속성 식별자로 사용되는 값을 포함합니다.

UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Automation.AutomationElementIdentifiers(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

public ref class AutomationElementIdentifiers 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 AutomationElementIdentifiers 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 AutomationElementIdentifiers

Public NotInheritable Class AutomationElementIdentifiers

상속

Object IInspectable AutomationElementIdentifiers

특성

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 요구 사항

디바이스 패밀리	Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

설명

AutomationElementIdentifiers 와 같은 클래스는 Microsoft UI 자동화 공통 공급자 패턴의 Windows 런타임 구현에 대한 식별자입니다. AutomationElementIdentifiers 는 특정 자동화 컨트롤 패턴과 관련된 것이 아니라 기본 피어 기능의 일부인 일반 자동화 피어 속성을 식별합니다. Windows 런타임 사용자 지정 자동화 피어를 기반으로 AutomationPeer 하는 경우 이러한 식별자를 사용할 수 있습니다FrameworkElementAutomationPeer. 이러한 식별자는 사용자 고유의 피어를 RaisePropertyChangedEvent 참조하는 제어 코드 또는 항목 컨테이너 피어에서 만드는 호출에 FindItemByProperty 필요합니다.

이 동일한 속성 식별자 집합은 일반적으로 클라이언트를 구현하고 Microsoft UI 자동화 트리를 검사하는 데 사용하는 기술에 따라 다른 방식으로 클라이언트에 노출됩니다. 클라이언트에 대한 이러한 속성 식별자 목록 중 하나는 Automation 요소 속성 식별자 항목에 설명되어 있습니다.

속성

AcceleratorKeyProperty	액셀러레이터 키 자동화 속성을 식별합니다. 액셀러레이터 키 속성 값은 메서드에서 반환됩니다 GetAcceleratorKey . UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Automation.AutomationElementIdentifiers.AcceleratorKeyProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
AccessKeyProperty	액세스 키 자동화 속성을 식별합니다. 액세스 키 속성 값은 메서드에서 반환됩니다 GetAccessKey . UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Automation.AutomationElementIdentifiers.AccessKeyProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
AnnotationsProperty	주석 자동화 속성의 식별자를 가져옵니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Automation.AutomationElementIdentifiers.AnnotationsProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
AutomationIdProperty	Automation 요소 식별자 자동화 속성을 식별합니다. 자동화 요소 식별자 값은 메서드에서 반환됩니다 GetAutomationId . UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Automation.AutomationElementIdentifiers.AutomationIdProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
BoundingRectangleProperty	경계 사각형 자동화 속성을 식별합니다. 경계 사각형 속성 값은 메서드에서 GetBoundingRectangle 반환됩니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Automation.AutomationElementIdentifiers.BoundingRectangleProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
ClassNameProperty	클래스 이름 자동화 속성을 식별합니다. 클래스 이름 속성 값은 메서드에서 반환됩니다 GetClassName . UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Automation.AutomationElementIdentifiers.ClassNameProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
ClickablePointProperty	클릭 가능한 지점 자동화 속성을 식별합니다. 유효한 클릭 가능한 지점 속성 값이 메서드에 GetClickablePoint 의해 반환됩니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Automation.AutomationElementIdentifiers.ClickablePointProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
ControlledPeersProperty	제어된 피어 자동화 속성을 식별합니다. 제어된 피어 목록이 메서드에서 GetControlledPeers 반환됩니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Automation.AutomationElementIdentifiers.ControlledPeersProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
ControlTypeProperty	컨트롤 형식 자동화 속성을 식별합니다. 컨트롤 형식 속성 값은 메서드에서 반환됩니다 GetAutomationControlType . UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Automation.AutomationElementIdentifiers.ControlTypeProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
CultureProperty	Automation 요소에 대한 로캘 식별자를 포함하는 Culture 속성을 식별합니다(예: "en-US" 또는 영어(미국)에 대한 0x0409). UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Automation.AutomationElementIdentifiers.CultureProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
DescribedByProperty	Automation 속성으로 설명된 것을 식별합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Automation.AutomationElementIdentifiers.DescribedByProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
FlowsFromProperty	자동화 속성 "흐름"을 식별합니다. "flows from" 속성 값은 메서드에서 GetFlowsFrom 반환됩니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Automation.AutomationElementIdentifiers.FlowsFromProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
FlowsToProperty	자동화 속성 "흐름"을 식별합니다. "flows to" 속성 값은 메서드에서 GetFlowsTo 반환됩니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Automation.AutomationElementIdentifiers.FlowsToProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
FullDescriptionProperty	전체 설명 자동화 속성을 식별합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Automation.AutomationElementIdentifiers.FullDescriptionProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
HasKeyboardFocusProperty	키보드 포커스 자동화 속성을 식별합니다. 키보드 포커스 상태는 메서드에서 반환됩니다 HasKeyboardFocus . UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Automation.AutomationElementIdentifiers.HasKeyboardFocusProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
HeadingLevelProperty	제목 수준 자동화 속성을 식별합니다. 메서드에서 제목 수준 속성 값이 GetHeadingLevel 반환됩니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Automation.AutomationElementIdentifiers.HeadingLevelProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
HelpTextProperty	도움말 텍스트 자동화 속성을 식별합니다. 도움말 텍스트 속성 값은 메서드에서 반환됩니다 GetHelpText . UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Automation.AutomationElementIdentifiers.HelpTextProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
IsContentElementProperty	콘텐츠 요소 결정 자동화 속성을 식별합니다. 콘텐츠 요소 상태는 요소에 최종 사용자에게 유용한 콘텐츠가 포함되어 있는지 여부를 나타냅니다. 현재 상태는 메서드에서 반환됩니다 IsContentElement . UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Automation.AutomationElementIdentifiers.IsContentElementProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
IsControlElementProperty	제어 요소 결정 자동화 속성을 식별합니다. 컨트롤 요소 상태는 요소에 조작할 수 있는 사용자 인터페이스 구성 요소가 포함되어 있는지 여부를 나타냅니다. 현재 상태는 메서드에서 반환됩니다 IsControlElement . UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Automation.AutomationElementIdentifiers.IsControlElementProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
IsDataValidForFormProperty	데이터가 양식에 유효한지 여부를 나타내는 부울 자동화 속성을 식별합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Automation.AutomationElementIdentifiers.IsDataValidForFormProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
IsDialogProperty	자동화 요소가 대화 상자 창인지 여부를 나타내는 부울 AutomationProperties.IsDialogProperty 을 식별합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Automation.AutomationElementIdentifiers.IsDialogProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
IsEnabledProperty	활성화된 결정 자동화 속성을 식별합니다. 사용 상태는 자동화 피어에서 참조하는 항목을 사용할 수 있는지 여부를 나타냅니다. 현재 상태는 메서드에서 반환됩니다 IsEnabled . UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Automation.AutomationElementIdentifiers.IsEnabledProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
IsKeyboardFocusableProperty	키보드 포커스 가능 결정 자동화 속성을 식별합니다. 키보드 포커스 가능 상태는 메서드에서 반환됩니다 IsKeyboardFocusable . UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Automation.AutomationElementIdentifiers.IsKeyboardFocusableProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
IsOffscreenProperty	오프스크린 결정 자동화 속성을 식별합니다. 오프스크린 상태는 자동화 피어에서 참조하는 항목이 화면에서 벗어났는지 여부를 나타냅니다. 현재 상태는 메서드에서 반환됩니다 IsOffscreen . UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Automation.AutomationElementIdentifiers.IsOffscreenProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
IsPasswordProperty	암호 결정 자동화 속성을 식별합니다. 암호 상태는 자동화 피어에서 참조하는 항목에 암호가 포함되어 있는지 여부를 나타냅니다. 현재 상태는 메서드에서 반환됩니다 IsPassword . UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Automation.AutomationElementIdentifiers.IsPasswordProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
IsPeripheralProperty	자동화 요소가 주변 장치 UI를 나타내는지 여부를 나타내는 부울 자동화 속성을 식별합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Automation.AutomationElementIdentifiers.IsPeripheralProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
IsRequiredForFormProperty	양식 요구 사항 결정 자동화 속성을 식별합니다. 양식 요구 사항 상태는 폼에서 요소를 완료해야 하는지 여부를 나타냅니다. 현재 상태는 메서드에서 반환됩니다 IsRequiredForForm . UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Automation.AutomationElementIdentifiers.IsRequiredForFormProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
ItemStatusProperty	항목 상태 자동화 속성을 식별합니다. 현재 항목 상태는 메서드에서 반환됩니다 GetItemStatus . UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Automation.AutomationElementIdentifiers.ItemStatusProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
ItemTypeProperty	항목 유형 자동화 속성을 식별합니다. 항목 형식 값은 메서드에서 GetItemType 반환됩니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Automation.AutomationElementIdentifiers.ItemTypeProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
LabeledByProperty	레이블이 지정된 피어 자동화 속성을 식별합니다. 자동화 피어에 대한 레이블 지정 관계는 메서드에서 GetLabeledBy 반환됩니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Automation.AutomationElementIdentifiers.LabeledByProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
LandmarkTypeProperty	랜드마크 형식 자동화 속성의 식별자를 가져옵니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Automation.AutomationElementIdentifiers.LandmarkTypeProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
LevelProperty	수준 자동화 속성의 식별자를 가져옵니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Automation.AutomationElementIdentifiers.LevelProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
LiveSettingProperty	라이브 설정 자동화 속성을 식별합니다. 라이브 설정 속성 값은 메서드에서 반환됩니다 GetLiveSetting . UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Automation.AutomationElementIdentifiers.LiveSettingProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
LocalizedControlTypeProperty	내레이터 읽은 컨트롤 형식을 변경하는 메커니즘을 제공하는 지역화된 컨트롤 형식 자동화 속성을 식별합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Automation.AutomationElementIdentifiers.LocalizedControlTypeProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
LocalizedLandmarkTypeProperty	지역화된 랜드마크 형식 자동화 속성의 식별자를 가져옵니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Automation.AutomationElementIdentifiers.LocalizedLandmarkTypeProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
NameProperty	요소 이름 자동화 속성을 식별합니다. 현재 이름은 메서드에서 반환됩니다 GetName . UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Automation.AutomationElementIdentifiers.NameProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
OrientationProperty	방향 자동화 속성을 식별합니다. 현재 방향 값은 메서드에서 반환됩니다 GetOrientation . UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Automation.AutomationElementIdentifiers.OrientationProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
PositionInSetProperty	set automation 속성의 위치에 대한 식별자를 가져옵니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Automation.AutomationElementIdentifiers.PositionInSetProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
SizeOfSetProperty	set automation 속성의 크기 식별을 가져옵니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Automation.AutomationElementIdentifiers.SizeOfSetProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

추가 정보

• FrameworkElementAutomationPeer
• Automation 요소 속성 식별자
• 컨트롤 패턴 및 인터페이스
• 사용자 지정 자동화 피어