다음을 통해 공유


Automation 요소 속성 식별자

이 항목에서는 Microsoft UI 자동화 요소의 속성을 식별하는 명명된 상수에 대해 설명합니다.

상수/값 설명
UIA_AcceleratorKeyPropertyId
30006
Automation 요소에 대한 바로 가기 키(바로 가기 키라고도 함) 조합을 포함하는 문자열인 AcceleratorKey 속성을 식별합니다.
바로 가기 키 조합은 작업을 호출합니다. 예를 들어, CTRL + O는 대개 호출 하는 열려 파일 일반 대화 상자. AcceleratorKey 속성이 있는 자동화 요소는 바로 가기 명령과 동일한 작업에 대해 Invoke 컨트롤 패턴을 구현할 수 있습니다.
변형 유형: VT_BSTR
기본값: 빈 문자열
UIA_AccessKeyPropertyId
30007
Automation 요소에 대한 액세스 키 문자를 포함하는 문자열인 AccessKey 속성을 식별합니다.
액세스 키(니모닉이라고도 함)는 연결된 메뉴 함수를 활성화하는 단추와 같은 컨트롤의 메뉴, 메뉴 항목 또는 레이블 텍스트에 있는 문자입니다. 예를 들어 액세스 키가 일반적으로 F인 파일 메뉴를 열려면 사용자가 Alt+F를 누릅니다.
변형 유형: VT_BSTR
기본값: 빈 문자열
UIA_AnnotationObjectsPropertyId
30156
주석, 머리글, 바닥글 등 문서의 주석 개체 목록인 AnnotationObjects 속성을 식별합니다.
변형 유형: VT_I4 | VT_ARRAY
기본값: 빈 배열
UIA_AnnotationTypesPropertyId
30155
주석, 머리글, 바닥글 등 문서의 주석 유형 목록인 AnnotationTypes 속성을 식별합니다.
변형 유형: VT_I4 | VT_ARRAY
기본값: 빈 배열
UIA_AriaPropertiesPropertyId
30102
자동화 요소에 대한 ARIA(Access Rich Internet Application) 속성 정보를 포함하는 형식이 지정된 문자열인 AriaProperties 속성을 식별합니다. ARIA 상태 및 속성을 UI 자동화 속성 및 함수에 매핑하는 방법에 대한 자세한 내용은 W3C Access Rich Internet 애플리케이션 사양에 대한 UI 자동화를 참조하세요.
AriaProperties는 (equals) 및 ;(세미콜론)의 구분 기호가 있는 이름/값 쌍의 = 컬렉션입니다(예: "checked=true;disabled=false"). ( \ 백슬래시)는 이러한 구분 기호 문자 또는 \ 값에 나타날 때 이스케이프 문자로 사용됩니다. 보안 및 기타 이유로 이 속성의 공급자 구현은 원래 ARIA 속성의 유효성을 검사하는 단계를 수행할 수 있습니다. 그러나 필수는 아닙니다.
변형 유형: VT_BSTR
기본값: 빈 문자열
UIA_AriaRolePropertyId
30101
자동화 요소에 대한 ARIA(Access Rich Internet Application) 역할 정보를 포함하는 문자열인 AriaRole 속성을 식별합니다. ARIA 역할을 UI 자동화 컨트롤 형식에 매핑하는 방법에 대한 자세한 내용은 W3C Access Rich Internet 애플리케이션 사양에 대한 UI 자동화를 참조하세요.

참고:
옵션으로 사용자 에이전트는 LocalizedControlType 속성에서 W3C ARIA 역할에 대한 지역화된 설명을 제공할 수도 있습니다. 지역화된 문자열을 지정하지 않으면 시스템에서 요소에 대한 기본 LocalizedControlType 문자열을 제공합니다.



변형 유형: VT_BSTR
기본값: 빈 문자열

UIA_AutomationIdPropertyId
30011
Automation 요소에 대한 UI 자동화 식별자(ID)를 포함하는 문자열인 AutomationId 속성을 식별합니다.
사용할 수 있는 경우 요소의 AutomationId는 로컬 언어에 관계없이 애플리케이션의 모든 instance 동일해야 합니다. 값은 형제 요소 간에 고유해야 하지만 전체 데스크톱에서 반드시 고유하지는 않습니다. 예를 들어 애플리케이션의 여러 인스턴스 또는 Microsoft Windows Explorer 여러 폴더 보기에는 "SystemMenuBar"와 같은 동일한 AutomationId 속성을 가진 요소가 포함될 수 있습니다.
AutomationId에 대한 지원은 항상 더 나은 자동화된 테스트 지원을 위해 권장되지만 이 속성은 필수는 아닙니다. 지원되는 경우 AutomationId 는 UI 언어에 관계없이 실행되는 테스트 자동화 스크립트를 만드는 데 유용합니다. 클라이언트는 다른 애플리케이션에서 노출하는 AutomationId 값에 대해 어떠한 가정도 하지 않아야 합니다. AutomationId 는 애플리케이션의 여러 릴리스 또는 빌드에서 안정적으로 보장되지 않습니다.
변형 유형: VT_BSTR
기본값: 빈 문자열
UIA_BoundingRectanglePropertyId
30001
Automation 요소를 완전히 둘러싸는 사각형의 좌표를 지정하는 BoundingRectangle 속성을 식별합니다. 사각형은 실제 화면 좌표로 표현됩니다. UI 항목의 셰이프 또는 클릭 가능한 영역이 불규칙하거나 항목이 다른 UI 요소에 의해 가려진 경우 클릭할 수 없는 점을 포함할 수 있습니다.
변형 형식: VT_R8 | VT_ARRAY
기본값: [0,0,0,0]

참고:
항목이 현재 UI를 표시하지 않는 경우 이 속성은 NULL 입니다.



UIA_CenterPointPropertyId
30165
Automation 요소의 가운데 X 및 Y 점 좌표를 지정하는 CenterPoint 속성을 식별합니다. 좌표 공간은 공급자가 논리적으로 페이지를 고려하는 공간입니다.
변형 형식: VT_R8 | VT_ARRAY
기본값: VT_EMPTY
UIA_ClassNamePropertyId
30012
컨트롤 개발자가 할당한 자동화 요소의 클래스 이름을 포함하는 문자열인 ClassName 속성을 식별합니다.
클래스 이름은 UI 자동화 공급자의 구현에 따라 달라지므로 항상 표준 형식은 아닙니다. 그러나 클래스 이름이 알려진 경우 애플리케이션이 예상 자동화 요소와 함께 작동하는지 확인하는 데 사용할 수 있습니다.
변형 유형: VT_BSTR
기본값: 빈 문자열
UIA_ClickablePointPropertyId
30014
클릭할 수 있는 자동화 요소의 지점인 ClickablePoint 속성을 식별합니다. 요소가 다른 창에 의해 완전히 또는 부분적으로 가려진 경우 요소를 클릭할 수 없습니다.
변형 형식: VT_R8 | VT_ARRAY
기본값: VT_EMPTY
UIA_ControllerForPropertyId
30104
ControllerFor 속성을 식별합니다. 이 속성은 이 속성을 지원하는 자동화 요소에 의해 조작되는 자동화 요소의 배열입니다.
ControllerFor 는 자동화 요소가 애플리케이션 UI 또는 데스크톱의 하나 이상의 세그먼트에 영향을 줄 때 사용됩니다. 그렇지 않으면 컨트롤 작업의 영향을 UI 요소와 연결하기 어렵습니다.
이 식별자는 일반적으로 자동 제안 접근성에 사용됩니다.
공급자의 변형 유형: VT_UNKNOWN | VT_ARRAY
클라이언트의 변형 유형: VT_UNKNOWN (IUIAutomationElementArray )
기본값: 빈 배열
UIA_ControlTypePropertyId
30003
Automation 요소의 형식을 식별하는 클래스인 ControlType 속성을 식별합니다. ControlType은 단추 또는 검사 상자와 같은 잘 알려진 UI 컨트롤 기본 형식으로 UI 요소의 특성을 정의합니다.
변형 유형: VT_I4
기본값: UIA_CustomControlTypeId

참고:
automation 요소가 완전히 새로운 유형의 컨트롤을 나타내는 경우에만 기본값을 사용합니다.



UIA_CulturePropertyId
30015
Automation 요소에 대한 로캘 식별자를 포함하는 Culture 속성을 식별합니다(예: 0x0409 "en-US" 또는 영어(미국)).
각 로캘에는 고유 식별자, 언어 식별자 및 정렬 순서 식별자로 구성된 32비트 값이 있습니다. 로캘 식별자는 표준 국제 숫자 약어이며 설치된 운영 체제에 정의된 로캘 중 하나를 고유하게 식별하는 데 필요한 구성 요소를 가집니다. 자세한 내용은 언어 식별자 상수 및 문자열을 참조하세요.
이 속성은 제어 단위로 존재할 수 있지만 일반적으로 애플리케이션 수준에서만 사용할 수 있습니다.
변형 유형: VT_I4
기본값: 0
UIA_DescribedByPropertyId
30105
Automation 요소에 대한 자세한 정보를 제공하는 요소의 배열인 DescribedBy 속성을 식별합니다.
DescribedBy 는 애플리케이션 UI의 다른 세그먼트에서 자동화 요소를 설명할 때 사용됩니다. 예를 들어 속성은 복잡한 사용자 지정 목록 개체에서 "85개 그룹의 항목 2,529개, 선택한 항목 10개"의 텍스트 요소를 가리킬 수 있습니다. 클라이언트에 대해 개체 모델을 사용하여 유사한 정보를 소화하는 대신 , DescribedBy 속성은 UI 요소를 설명하는 유용한 최종 사용자 정보를 이미 제공할 수 있는 UI 요소에 대한 빠른 액세스를 제공할 수 있습니다.
공급자의 변형 유형: VT_UNKNOWN | VT_ARRAY
클라이언트에 대한 변형 형식: VT_UNKNOWN (IUIAutomationElementArray)
기본값: 빈 배열
UIA_FillColorPropertyId
30160
Automation 요소를 채우는 데 사용되는 색을 지정하는 FillColor 속성을 식별합니다. 이 특성은 RGB 또는 RGBA 색을 지정하는 데 사용되는 32비트 값인 COLORREF로 지정됩니다.
변형 유형: VT_I4
기본값: 0
UIA_FillTypePropertyId
30162
없음, 색, 그라데이션, 그림, 패턴 등 자동화 요소를 채우는 데 사용되는 패턴을 지정하는 FillType 속성을 식별합니다.
변형 유형: VT_I4
기본값: 0
UIA_FlowsFromPropertyId
30148
현재 자동화 요소 앞의 읽기 순서를 제안하는 자동화 요소의 배열인 FlowsFrom 속성을 식별합니다. Windows 8부터 지원됩니다.
FlowsFrom 속성은 자동화 요소가 사용자가 인식하는 것과 동일한 읽기 순서로 노출되거나 구조화되지 않은 경우 읽기 순서를 지정합니다. FlowsFrom 속성은 여러 개의 이전 요소를 지정할 수 있지만 일반적으로 읽기 순서에 이전 요소만 포함됩니다.
공급자의 변형 유형: VT_UNKNOWN | VT_ARRAY
클라이언트에 대한 변형 형식: VT_UNKNOWN (IUIAutomationElementArray)
기본값: 빈 배열
UIA_FlowsToPropertyId
30106
현재 자동화 요소 뒤의 읽기 순서를 제안하는 자동화 요소의 배열인 FlowsTo 속성을 식별합니다.
FlowsTo 속성은 자동화 요소가 사용자가 인식하는 것과 동일한 읽기 순서로 노출되거나 구조화되지 않은 경우 읽기 순서를 지정합니다. FlowsTo 속성은 여러 개의 성공 요소를 지정할 수 있지만 일반적으로 읽기 순서에 다음 요소만 포함됩니다.
공급자의 변형 유형: VT_UNKNOWN | VT_ARRAY
클라이언트에 대한 변형 형식: VT_UNKNOWN (IUIAutomationElementArray)
기본값: 빈 배열
UIA_FrameworkIdPropertyId
30024
Automation 요소가 속한 기본 UI 프레임워크의 이름을 포함하는 문자열인 FrameworkId 속성을 식별합니다.
FrameworkId를 사용하면 클라이언트 애플리케이션이 특정 UI 프레임워크에 따라 자동화 요소를 다르게 처리할 수 있습니다. 속성 값의 예로는 "Win32", "WinForm" 및 "DirectUI"가 있습니다.
변형 유형: VT_BSTR
기본값: 빈 문자열
UIA_FullDescriptionPropertyId
30159
FullDescription 속성은 요소에 대한 확장 설명 텍스트를 포함할 수 있는 지역화된 문자열을 노출합니다. FullDescription 은 요소 이름에 적합한 것보다 요소에 대한 보다 완전한 설명을 포함할 수 있습니다.
변형 유형: VT_BSTR
기본값: 빈 문자열
UIA_HasKeyboardFocusPropertyId
30008
Automation 요소에 키보드 포커스가 있는지 여부를 나타내는 부울 값인 HasKeyboardFocus 속성을 식별합니다.
변형 유형: VT_BOOL
기본값: FALSE
UIA_HeadingLevelPropertyId
30173
UI 자동화 요소의 제목 수준을 나타내는 HeadingLevel 속성을 식별합니다.
변형 유형: VT_I4
기본값: HeadingLevel_None
UIA_HelpTextPropertyId
30013
Automation 요소와 연결된 도움말 텍스트 문자열인 HelpText 속성을 식별합니다.
HelpText 속성은 편집 또는 목록 컨트롤에 자리 표시자 텍스트가 표시되어 지원될 수 있습니다. 예를 들어 "검색을 위해 여기에 텍스트 입력"은 사용자의 실제 입력 앞에 텍스트를 배치하는 편집 컨트롤의 HelpText 속성에 적합한 후보입니다. 그러나 편집 컨트롤의 name 속성에는 적합하지 않습니다.
HelpText가 지원되는 경우 문자열은 애플리케이션 UI 언어 또는 운영 체제 기본 UI 언어와 일치해야 합니다.
변형 유형: VT_BSTR
기본값: 빈 문자열
UIA_IsContentElementPropertyId
30017
요소가 자동화 요소 트리의 콘텐츠 뷰에 표시되는지 여부를 지정하는 부울 값인 IsContentElement 속성을 식별합니다. 자세한 내용은 UI 자동화 트리 개요를 참조하세요.

참고:
콘텐츠 보기에 요소가 표시되려면 IsContentElement 속성과 IsControlElement 속성이 모두 TRUE여야 합니다.



변형 유형: VT_BOOL
기본값: TRUE

UIA_IsControlElementPropertyId
30016
요소가 자동화 요소 트리의 컨트롤 뷰에 표시되는지 여부를 지정하는 부울 값인 IsControlElement 속성을 식별합니다. 자세한 내용은 UI 자동화 트리 개요를 참조하세요.
변형 유형: VT_BOOL
기본값: TRUE
UIA_IsDataValidForFormPropertyId
30103
입력하거나 선택한 값이 자동화 요소와 연결된 양식 규칙에 유효한지 여부를 나타내는 부울 값인 IsDataValidForForm 속성을 식별합니다. 예를 들어 사용자가 5자리 또는 9자리가 필요한 우편 번호 필드에 대해 "425-555-5555"를 입력한 경우 IsDataValidForForm 속성을 FALSE 로 설정하여 데이터가 유효하지 않음을 나타낼 수 있습니다.
변형 형식: VT_BOOL
기본값: FALSE
UIA_IsDialogPropertyId
30174
자동화 요소가 대화 상자 창인지 여부를 나타내는 부울 값인 IsDialog 속성을 식별합니다. 예를 들어 화면 읽기 프로그램과 같은 보조 기술은 일반적으로 대화 상자의 제목, 대화 상자의 포커스가 있는 컨트롤, 포커스가 있는 컨트롤까지 대화 내용("닫기 전에 변경 내용을 저장하시겠습니까")을 말합니다. 표준 창의 경우 화면 읽기 프로그램은 일반적으로 창 제목과 포커스가 있는 컨트롤을 말합니다. IsDialog 속성을 TRUE로 설정하여 클라이언트 애플리케이션이 요소를 대화 상자 창으로 처리해야 함을 나타낼 수 있습니다.
변형 형식: VT_BOOL
기본값: FALSE
UIA_IsEnabledPropertyId
30010
자동화 요소에서 참조하는 UI 항목이 활성화되어 상호 작용할 수 있는지 여부를 나타내는 부울 값인 IsEnabled 속성을 식별합니다.
컨트롤의 사용 상태가 FALSE이면 자식 컨트롤도 사용하도록 설정되지 않은 것으로 간주됩니다. 부모 컨트롤의 상태가 변경되면 클라이언트는 자식 요소에서 속성 변경 이벤트를 예상해서는 안 됩니다.
변형 형식: VT_BOOL
기본값: FALSE
UIA_IsKeyboardFocusablePropertyId
30009
자동화 요소가 키보드 포커스를 허용할 수 있는지 여부를 나타내는 부울 값인 IsKeyboardFocusable 속성을 식별합니다.
변형 형식: VT_BOOL
기본값: FALSE
UIA_IsOffscreenPropertyId
30022
자동화 요소가 완전히 보기 밖으로 스크롤되는지(예: 컨테이너 개체의 뷰포트 외부에 있는 목록 상자의 항목) 또는 축소된 보기(예: 트리 뷰 또는 메뉴의 항목 또는 최소화된 창)를 나타내는 부울 값인 IsOffscreen 속성을 식별합니다. 요소에 포커스를 받을 수 있는 클릭 가능한 점이 있는 경우 요소의 일부가 화면 끄기인 동안 요소가 화면에 표시되는 것으로 간주됩니다.
속성의 값 요소가 특정 모니터에 표시 되는지 여부 또는 다른 windows에서 폐색 받지 않습니다.
IsOffscreen 속성이 TRUE이면 UI 요소가 화면에서 스크롤되거나 축소됩니다. 요소는 일시적으로 숨겨지지만 최종 사용자의 인식에 남아 있으며 UI 모델에 계속 포함됩니다. 스크롤하고 드롭다운을 클릭하여 개체를 다시 보기로 가져올 수 있습니다.
최종 사용자가 전혀 인식하지 못하거나 "프로그래밍 방식으로 숨겨져 있는" 개체(예: 해제되었지만 기본 개체가 애플리케이션에서 여전히 캐시된 대화 상자)는 처음에 Automation 요소 트리에 없어야 합니다( IsOffscreen 의 상태를 TRUE로 설정하는 대신).
변형 형식: VT_BOOL
기본값: FALSE
UIA_IsPasswordPropertyId
30019
자동화 요소에 보호된 콘텐츠 또는 암호가 포함되어 있는지 여부를 나타내는 부울 값인 IsPassword 속성을 식별합니다.
IsPassword 속성이 TRUE이고 요소에 키보드 포커스가 있는 경우 클라이언트 애플리케이션은 사용자의 보호된 정보를 노출할 수 있는 키보드 에코 또는 키보드 입력 피드백을 사용하지 않도록 설정해야 합니다. 보호된 요소(편집 컨트롤)의 Value 속성에 액세스하려고 하면 오류가 발생할 수 있습니다.
변형 형식: VT_BOOL
기본값: FALSE
UIA_IsPeripheralPropertyId
30150
자동화 요소가 주변 장치 UI를 나타내는지 여부를 나타내는 부울 값인 IsPeripheral 속성을 식별합니다. 주변 장치 UI가 나타나고 사용자 상호 작용을 지원하지만 키보드 포커스가 나타나면 사용하지 않습니다. 주변 장치 UI의 예로는 팝업, 플라이아웃, 상황에 맞는 메뉴 또는 부동 알림이 있습니다. Windows 8.1 부터 지원합니다.
IsPeripheral 속성이 TRUE인 경우 클라이언트 애플리케이션은 현재 키보드 대화형인 경우에도 요소가 포커스를 가져갔다고 가정할 수 없습니다.
이 속성은 다음 컨트롤 형식과 관련이 있습니다.
  • UIA_GroupControlTypeId
  • UIA_MenuControlTypeId
  • UIA_PaneControlTypeId
  • UIA_ToolBarControlTypeId
  • UIA_ToolTipControlTypeId
  • UIA_WindowControlTypeId
  • UIA_CustomControlTypeId
변형 형식: VT_BOOL
기본값: FALSE
UIA_IsRequiredForFormPropertyId
30025
양식에서 자동화 요소를 작성해야 하는지 여부를 나타내는 부울 값인 IsRequiredForForm 속성을 식별합니다.
변형 형식: VT_BOOL
기본값: FALSE
UIA_ItemStatusPropertyId
30026
Automation 요소 항목의 상태 설명하는 텍스트 문자열인 ItemStatus 속성을 식별합니다.
ItemStatus를 사용하면 클라이언트가 요소가 항목에 대한 상태 전달하고 있는지 여부와 상태 무엇인지 확인할 수 있습니다. 예를 들어, "Busy" 또는 "연결 됨" 메시징 애플리케이션에서 대화 상대와 연결 된 항목 수 있습니다.
ItemStatus가 지원되는 경우 문자열은 애플리케이션 UI 언어 또는 운영 체제 기본 UI 언어와 일치해야 합니다.
변형 유형: VT_BSTR
기본값: 빈 문자열
UIA_ItemTypePropertyId
300021
Automation 요소의 형식을 설명하는 텍스트 문자열인 ItemType 속성을 식별합니다.
ItemType 은 목록, 트리 뷰 또는 데이터 표의 항목에 대한 정보를 가져오는 데 사용됩니다. 예를 들어 "문서 File" 또는 "폴더" 파일 디렉터리 보기의 항목 수 있습니다.
ItemType이 지원되는 경우 문자열은 애플리케이션 UI 언어 또는 운영 체제 기본 UI 언어와 일치해야 합니다.
변형 유형: VT_BSTR
기본값: 빈 문자열
UIA_LabeledByPropertyId
30018
이 요소의 텍스트 레이블을 포함하는 자동화 요소인 LabeledBy 속성을 식별합니다.
이 속성을 사용하여 콤보 상자의 정적 텍스트 레이블을 검색할 수 있습니다.
변형 형식: VT_UNKNOWN
기본값: NULL
UIA_LandmarkTypePropertyId
30157
요소와 연결된 랜드마크 형식 식별자LandmarkType 속성을 식별합니다.
LandmarkType 속성은 요소 그룹을 나타내는 요소를 설명합니다. 예를 들어 검색 랜드마크는 검색을 위한 관련 컨트롤 집합을 나타낼 수 있습니다.
UIA_CustomLandmarkTypeId 사용하는 경우 사용자 지정 랜드마크를 설명하는 데 UIA_LocalizedLandmarkTypePropertyId 필요합니다.
변형 형식: VT_I4
기본값: 0
UIA_LevelPropertyId
30154
Automation 요소와 연결된 1 기반 정수인 Level 속성을 식별합니다.
Level 속성은 계층 구조 또는 손상된 계층 구조 내에서 요소의 위치를 설명합니다. 예를 들어 글머리 기호/번호 매기기 목록, 머리글 또는 기타 구조화된 데이터 항목에는 다양한 부모/자식 관계가 있을 수 있습니다. 수준은 구조체에서 항목이 있는 위치를 설명합니다.
Level과 함께 CustomNavigation 컨트롤 패턴을 사용하는 것이 좋습니다.
변형 형식: VT_I4
기본값: 0
UIA_LiveSettingPropertyId
30135
라이브 지역을 나타내는 자동화 요소에서 지원하는 LiveSetting 속성을 식별합니다. LiveSetting 속성은 클라이언트가 라이브 지역에 대한 변경 내용을 사용자에게 알리는 데 사용해야 하는 "공손성" 수준을 나타냅니다. 이 속성은 LiveSetting 열거형의 값 중 하나일 수 있습니다. Windows 8부터 지원됩니다.
변형 형식: VT_I4
기본값: 0
UIA_LocalizedControlTypePropertyId
30004
Automation 요소가 나타내는 컨트롤의 형식을 설명하는 텍스트 문자열인 LocalizedControlType 속성을 식별합니다. 문자열에는 소문자만 포함되어야 합니다.
  • 정답: "button"
  • 틀렸습니다. "Button"

LocalizedControlType이 요소 공급자에 의해 지정되지 않은 경우 기본 지역화된 문자열은 요소의 컨트롤 형식(예: 단추 컨트롤 형식의 "단추")에 따라 프레임워크에서 제공됩니다. 사용자 지정 컨트롤 형식의 자동화 요소는 요소의 역할을 나타내는 지역화된 컨트롤 형식 문자열을 지원해야 합니다(예: 사용자가 색을 선택하고 지정할 수 있는 사용자 지정 컨트롤의 경우 "색 선택기").
사용자 지정 값이 제공되면 문자열이 애플리케이션 UI 언어 또는 운영 체제 기본 UI 언어와 일치해야 합니다.
변형 유형: VT_BSTR
기본값: 빈 문자열
UIA_LocalizedLandmarkTypePropertyId
30158
Automation 요소가 나타내는 랜드마크 유형을 설명하는 텍스트 문자열인 LocalizedLandmarkType을 식별합니다.
이는 UIA_CustomLandmarkTypeId 함께 사용해야 하지만 LocalizedLandmarkType 은 항상 LandmarkType 보다 우선해야 하며 LandmarkType 이전의 랜드마크를 설명하는 데 사용해야 합니다.
문자열은 애플리케이션 UI 언어 또는 운영 체제 기본 UI 언어와 일치해야 합니다.
변형 유형: VT_BSTR
기본값: 빈 문자열
UIA_NamePropertyId
30005
Automation 요소의 이름을 포함하는 문자열인 Name 속성을 식별합니다.
Name 속성은 화면의 레이블 텍스트와 동일해야 합니다. 예를 들어 Name 은 "Browse" 레이블이 있는 단추 요소에 대해 "찾아보기"여야 합니다. Name 속성에는 UI 텍스트 프레젠테이션에 밑줄이 그어져 있는 액세스 키(즉, "&")에 대한 니모닉 문자가 포함되어서는 안 됩니다. 또한 Name 속성은 이름과 레이블 간의 불일치로 인해 클라이언트 애플리케이션과 사용자 간에 혼동을 일으킬 수 있으므로 화면 레이블의 확장되거나 수정된 버전이 아니어야 합니다.
해당 레이블 텍스트가 화면에 표시되지 않거나 그래픽으로 바뀐 경우 대체 텍스트를 선택해야 합니다. 대체 텍스트는 간결하고 직관적이며 애플리케이션 UI 언어 또는 운영 체제 기본 UI 언어로 지역화되어야 합니다. 대체 텍스트는 시각적 세부 정보에 대한 자세한 설명이 아니라 간단한 텍스트로 레이블이 지정된 것처럼 UI 함수 또는 기능에 대한 간결한 설명이어야 합니다. 예를 들어 Windows 시작 메뉴 단추의 이름은 "파란색 둥근 구 그래픽의 Windows 로고"(단추) 대신 "시작"(단추)입니다. 자세한 내용은 이미지에 해당하는 텍스트 만들기를 참조하세요.
UI 레이블이 텍스트 그래픽을 사용하는 경우(예: 왼쪽에서 오른쪽으로 항목을 추가하는 단추에 ">>" 사용) Name 속성은 적절한 텍스트 대체(예: "추가")로 재정의되어야 합니다. 그러나 지역화 및 접근성 문제로 인해 텍스트 그래픽을 UI 레이블로 사용하는 방법은 권장되지 않습니다.
Name 속성에는 컨트롤 역할 또는 형식 정보(예: "button" 또는 "list")가 포함되어서는 안 됩니다. 그렇지 않으면 이러한 두 속성이 추가될 때 LocalizedControlType 속성의 텍스트와 충돌합니다(많은 기존 보조 기술에서 이 작업을 수행).
Name 속성은 형제 간에 고유 식별자로 사용할 수 없습니다. 그러나 UI 프레젠테이션과 일치하는 한 피어 간에 동일한 Name 값을 지원합니다. 테스트 자동화의 경우 클라이언트는 AutomationId 또는 RuntimeId 속성을 사용하는 것을 고려해야 합니다.
텍스트 패턴도 지원되는 한 텍스트 컨트롤에 Name 속성이 컨트롤 내에 표시되는 텍스트와 항상 동일할 필요는 없습니다.
변형 유형: VT_BSTR
기본값: 빈 문자열
UIA_NativeWindowHandlePropertyId
30020
Automation 요소 창의 핸들(HWND)을 나타내는 정수(있는 경우)인 NativeWindowHandle 속성을 식별합니다. 그렇지 않으면 이 속성은 0입니다.
변형 형식: VT_I4
기본값: 0
UIA_OptimizeForVisualContentPropertyId
30111
공급자가 표시되는 요소만 노출하는지 여부를 나타내는 부울 값인 OptimizeForVisualContent 속성을 식별합니다. 공급자는 이 속성을 사용하여 매우 큰 콘텐츠로 작업할 때 성능을 최적화할 수 있습니다. 예를 들어 사용자가 큰 콘텐츠를 통해 페이지를 만들면 공급자가 더 이상 표시되지 않는 콘텐츠 요소를 삭제할 수 있습니다. 콘텐츠 요소가 제거되면 공급자는 UIA_E_ELEMENTNOTAVAILABLE 오류 코드를 반환해야 합니다. Windows 8부터 지원됩니다.
변형 형식: VT_BOOL
기본값: FALSE
UIA_OrientationPropertyId
300023
Automation 요소가 나타내는 컨트롤의 방향을 나타내는 Orientation 속성을 식별합니다. 속성은 OrientationType 열거형 형식의 값으로 표현됩니다.
Orientation 속성은 세로 또는 가로 방향을 가질 수 있는 스크롤 막대 및 슬라이더와 같은 컨트롤에서 지원됩니다. 그렇지 않으면 항상 OrientationType_None 수 있습니다. 즉, 컨트롤에 방향이 없습니다.
변형 형식: VT_I4
기본값: 0(OrientationType_None)
UIA_OutlineColorPropertyId
30161
Automation 요소의 윤곽선에 사용되는 색을 지정하는 OutlineColor 속성을 식별합니다. 이 특성은 RGB 또는 RGBA 색을 지정하는 데 사용되는 32비트 값인 COLORREF로 지정됩니다.
변형 유형: VT_I4 | VT_ARRAY
기본값: 0
UIA_OutlineThicknessPropertyId
30164
Automation 요소의 윤곽선에 대한 너비를 지정하는 OutlineThickness 속성을 식별합니다.
변형 형식: VT_R8 | VT_ARRAY
기본값: VT_EMPTY
UIA_PositionInSetPropertyId
30152
Automation 요소와 연결된 1 기반 정수인 PositionInSet 속성을 식별합니다. PositionInSet 은 형제로 간주되는 요소 집합 내에서 요소의 서수 위치를 설명합니다.
PositionInSetSizeOfSet 속성과 함께 작동하여 집합의 서수 위치를 설명합니다.
변형 형식: VT_I4
기본값: 0
UIA_ProcessIdPropertyId
30002
Automation 요소의 프로세스 식별자(ID)를 나타내는 정수인 ProcessId 속성을 식별합니다.
프로세스 식별자(ID)는 운영 체제에 의해 할당됩니다. 볼 수 있습니다는 PID 열을 프로세스 작업 관리자의 탭 합니다.
변형 형식: VT_I4
기본값: 0
UIA_ProviderDescriptionPropertyId
30107
프록시 정보를 포함하여 자동화 요소에 대한 UI 자동화 공급자의 원본 정보를 포함하는 형식이 지정된 문자열인 ProviderDescription 속성을 식별합니다.
변형 유형: VT_BSTR
기본값: 빈 문자열
UIA_RotationPropertyId
30166
회전 각도를 지정하지 않은 단위로 지정하는 Rotation 속성을 식별합니다.
변형 형식: VT_R8
기본값: 0
UIA_RuntimeIdPropertyId
30000
Automation 요소의 식별자를 나타내는 정수 배열인 RuntimeId 속성을 식별합니다.
식별자는 데스크톱에서 고유하지만 생성된 데스크톱의 UI 내에서만 고유하도록 보장됩니다. 시간이 지남에 따라 식별자를 재사용할 수 있습니다.
RuntimeId의 형식은 변경할 수 있습니다. 반환된 식별자는 불투명 값으로 처리되고 비교에만 사용해야 합니다. 예를 들어 자동화 요소가 캐시에 있는지 여부를 확인합니다.
변형 유형: VT_I4 | VT_ARRAY
기본값: VT_EMPTY
UIA_SizePropertyId
30167
Automation 요소의 너비와 높이를 지정하는 Size 속성을 식별합니다.
변형 형식: VT_R8 | VT_ARRAY
기본값: VT_EMPTY
UIA_SizeOfSetPropertyId
30153
Automation 요소와 연결된 1 기반 정수인 SizeOfSet 속성을 식별합니다. SizeOfSet 은 형제로 간주되는 그룹 또는 집합의 자동화 요소 수를 설명합니다.
SizeOfSetPositionInSet 속성과 함께 작동하여 집합의 항목 수를 설명합니다.
변형 형식: VT_I4
기본값: 0
UIA_VisualEffectsPropertyId
30163
그림자, 반사, 네온, 부드러운 가장자리 또는 경사와 같은 자동화 요소에 대한 효과를 지정하는 비트 필드인 VisualEffects 속성을 식별합니다.
VisualEffects:
  • VisualEffects_Shadow: 0x1
  • VisualEffects_Reflection: 0x2
  • VisualEffects_Glow: 0x4
  • VisualEffects_SoftEdges: 0x8
  • VisualEffects_Bevel: 0x10
변형 형식: VT_I4
기본값: 0

요구 사항

요구 사항
지원되는 최소 클라이언트
Windows XP [데스크톱 앱 | UWP 앱]
지원되는 최소 서버
Windows Server 2003 [데스크톱 앱 | UWP 앱]
헤더
UIAutomationClient.h

추가 정보

개념

UI 자동화 속성 개요

UI 자동화 요소에서 속성 검색