Automation 요소 속성 식별자
이 항목에서는 Microsoft UI 자동화 요소의 속성을 식별하는 명명된 상수에 대해 설명합니다.
| 상수/값 | 설명 |
|---|---|
|
Automation 요소에 대한 바로 가기 키(바로 가기 키라고도 함) 조합을 포함하는 문자열인 AcceleratorKey 속성을 식별합니다. 바로 가기 키 조합은 작업을 호출합니다. 예를 들어, CTRL + O는 대개 호출 하는 열려 파일 일반 대화 상자. AcceleratorKey 속성이 있는 자동화 요소는 바로 가기 명령과 동일한 작업에 대해 Invoke 컨트롤 패턴을 구현할 수 있습니다. 변형 유형: VT_BSTR 기본값: 빈 문자열 |
|
Automation 요소에 대한 액세스 키 문자를 포함하는 문자열인 AccessKey 속성을 식별합니다. 액세스 키(니모닉이라고도 함)는 연결된 메뉴 함수를 활성화하는 단추와 같은 컨트롤의 메뉴, 메뉴 항목 또는 레이블 텍스트에 있는 문자입니다. 예를 들어 액세스 키가 일반적으로 F인 파일 메뉴를 열려면 사용자가 Alt+F를 누릅니다. 변형 유형: VT_BSTR 기본값: 빈 문자열 |
|
주석, 머리글, 바닥글 등 문서의 주석 개체 목록인 AnnotationObjects 속성을 식별합니다. 변형 유형: VT_I4 | VT_ARRAY 기본값: 빈 배열 |
|
주석, 머리글, 바닥글 등 문서의 주석 유형 목록인 AnnotationTypes 속성을 식별합니다. 변형 유형: VT_I4 | VT_ARRAY 기본값: 빈 배열 |
|
자동화 요소에 대한 ARIA(Access Rich Internet Application) 속성 정보를 포함하는 형식이 지정된 문자열인 AriaProperties 속성을 식별합니다. ARIA 상태 및 속성을 UI 자동화 속성 및 함수에 매핑하는 방법에 대한 자세한 내용은 W3C Access Rich Internet 애플리케이션 사양에 대한 UI 자동화를 참조하세요. AriaProperties는 (equals) 및 ;(세미콜론)의 구분 기호가 있는 이름/값 쌍의 = 컬렉션입니다(예: "checked=true;disabled=false"). ( \ 백슬래시)는 이러한 구분 기호 문자 또는 \ 값에 나타날 때 이스케이프 문자로 사용됩니다. 보안 및 기타 이유로 이 속성의 공급자 구현은 원래 ARIA 속성의 유효성을 검사하는 단계를 수행할 수 있습니다. 그러나 필수는 아닙니다. 변형 유형: VT_BSTR 기본값: 빈 문자열 |
|
자동화 요소에 대한 ARIA(Access Rich Internet Application) 역할 정보를 포함하는 문자열인 AriaRole 속성을 식별합니다. ARIA 역할을 UI 자동화 컨트롤 형식에 매핑하는 방법에 대한 자세한 내용은 W3C Access Rich Internet 애플리케이션 사양에 대한 UI 자동화를 참조하세요. 참고:
|
|
Automation 요소에 대한 UI 자동화 식별자(ID)를 포함하는 문자열인 AutomationId 속성을 식별합니다. 사용할 수 있는 경우 요소의 AutomationId는 로컬 언어에 관계없이 애플리케이션의 모든 instance 동일해야 합니다. 값은 형제 요소 간에 고유해야 하지만 전체 데스크톱에서 반드시 고유하지는 않습니다. 예를 들어 애플리케이션의 여러 인스턴스 또는 Microsoft Windows Explorer 여러 폴더 보기에는 "SystemMenuBar"와 같은 동일한 AutomationId 속성을 가진 요소가 포함될 수 있습니다. AutomationId에 대한 지원은 항상 더 나은 자동화된 테스트 지원을 위해 권장되지만 이 속성은 필수는 아닙니다. 지원되는 경우 AutomationId 는 UI 언어에 관계없이 실행되는 테스트 자동화 스크립트를 만드는 데 유용합니다. 클라이언트는 다른 애플리케이션에서 노출하는 AutomationId 값에 대해 어떠한 가정도 하지 않아야 합니다. AutomationId 는 애플리케이션의 여러 릴리스 또는 빌드에서 안정적으로 보장되지 않습니다. 변형 유형: VT_BSTR 기본값: 빈 문자열 |
|
Automation 요소를 완전히 둘러싸는 사각형의 좌표를 지정하는 BoundingRectangle 속성을 식별합니다. 사각형은 실제 화면 좌표로 표현됩니다. UI 항목의 셰이프 또는 클릭 가능한 영역이 불규칙하거나 항목이 다른 UI 요소에 의해 가려진 경우 클릭할 수 없는 점을 포함할 수 있습니다. 변형 형식: VT_R8 | VT_ARRAY 기본값: [0,0,0,0] 참고:
|
|
Automation 요소의 가운데 X 및 Y 점 좌표를 지정하는 CenterPoint 속성을 식별합니다. 좌표 공간은 공급자가 논리적으로 페이지를 고려하는 공간입니다. 변형 형식: VT_R8 | VT_ARRAY 기본값: VT_EMPTY |
|
컨트롤 개발자가 할당한 자동화 요소의 클래스 이름을 포함하는 문자열인 ClassName 속성을 식별합니다. 클래스 이름은 UI 자동화 공급자의 구현에 따라 달라지므로 항상 표준 형식은 아닙니다. 그러나 클래스 이름이 알려진 경우 애플리케이션이 예상 자동화 요소와 함께 작동하는지 확인하는 데 사용할 수 있습니다. 변형 유형: VT_BSTR 기본값: 빈 문자열 |
|
클릭할 수 있는 자동화 요소의 지점인 ClickablePoint 속성을 식별합니다. 요소가 다른 창에 의해 완전히 또는 부분적으로 가려진 경우 요소를 클릭할 수 없습니다. 변형 형식: VT_R8 | VT_ARRAY 기본값: VT_EMPTY |
|
ControllerFor 속성을 식별합니다. 이 속성은 이 속성을 지원하는 자동화 요소에 의해 조작되는 자동화 요소의 배열입니다. ControllerFor 는 자동화 요소가 애플리케이션 UI 또는 데스크톱의 하나 이상의 세그먼트에 영향을 줄 때 사용됩니다. 그렇지 않으면 컨트롤 작업의 영향을 UI 요소와 연결하기 어렵습니다. 이 식별자는 일반적으로 자동 제안 접근성에 사용됩니다. 공급자의 변형 유형: VT_UNKNOWN | VT_ARRAY 클라이언트의 변형 유형: VT_UNKNOWN (IUIAutomationElementArray ) 기본값: 빈 배열 |
|
Automation 요소의 형식을 식별하는 클래스인 ControlType 속성을 식별합니다. ControlType은 단추 또는 검사 상자와 같은 잘 알려진 UI 컨트롤 기본 형식으로 UI 요소의 특성을 정의합니다. 변형 유형: VT_I4 기본값: UIA_CustomControlTypeId 참고:
|
|
Automation 요소에 대한 로캘 식별자를 포함하는 Culture 속성을 식별합니다(예: 0x0409 "en-US" 또는 영어(미국)).각 로캘에는 고유 식별자, 언어 식별자 및 정렬 순서 식별자로 구성된 32비트 값이 있습니다. 로캘 식별자는 표준 국제 숫자 약어이며 설치된 운영 체제에 정의된 로캘 중 하나를 고유하게 식별하는 데 필요한 구성 요소를 가집니다. 자세한 내용은 언어 식별자 상수 및 문자열을 참조하세요. 이 속성은 제어 단위로 존재할 수 있지만 일반적으로 애플리케이션 수준에서만 사용할 수 있습니다. 변형 유형: VT_I4 기본값: 0 |
|
Automation 요소에 대한 자세한 정보를 제공하는 요소의 배열인 DescribedBy 속성을 식별합니다. DescribedBy 는 애플리케이션 UI의 다른 세그먼트에서 자동화 요소를 설명할 때 사용됩니다. 예를 들어 속성은 복잡한 사용자 지정 목록 개체에서 "85개 그룹의 항목 2,529개, 선택한 항목 10개"의 텍스트 요소를 가리킬 수 있습니다. 클라이언트에 대해 개체 모델을 사용하여 유사한 정보를 소화하는 대신 , DescribedBy 속성은 UI 요소를 설명하는 유용한 최종 사용자 정보를 이미 제공할 수 있는 UI 요소에 대한 빠른 액세스를 제공할 수 있습니다. 공급자의 변형 유형: VT_UNKNOWN | VT_ARRAY 클라이언트에 대한 변형 형식: VT_UNKNOWN (IUIAutomationElementArray) 기본값: 빈 배열 |
|
Automation 요소를 채우는 데 사용되는 색을 지정하는 FillColor 속성을 식별합니다. 이 특성은 RGB 또는 RGBA 색을 지정하는 데 사용되는 32비트 값인 COLORREF로 지정됩니다. 변형 유형: VT_I4 기본값: 0 |
|
없음, 색, 그라데이션, 그림, 패턴 등 자동화 요소를 채우는 데 사용되는 패턴을 지정하는 FillType 속성을 식별합니다. 변형 유형: VT_I4 기본값: 0 |
|
현재 자동화 요소 앞의 읽기 순서를 제안하는 자동화 요소의 배열인 FlowsFrom 속성을 식별합니다. Windows 8부터 지원됩니다. FlowsFrom 속성은 자동화 요소가 사용자가 인식하는 것과 동일한 읽기 순서로 노출되거나 구조화되지 않은 경우 읽기 순서를 지정합니다. FlowsFrom 속성은 여러 개의 이전 요소를 지정할 수 있지만 일반적으로 읽기 순서에 이전 요소만 포함됩니다. 공급자의 변형 유형: VT_UNKNOWN | VT_ARRAY 클라이언트에 대한 변형 형식: VT_UNKNOWN (IUIAutomationElementArray) 기본값: 빈 배열 |
|
현재 자동화 요소 뒤의 읽기 순서를 제안하는 자동화 요소의 배열인 FlowsTo 속성을 식별합니다. FlowsTo 속성은 자동화 요소가 사용자가 인식하는 것과 동일한 읽기 순서로 노출되거나 구조화되지 않은 경우 읽기 순서를 지정합니다. FlowsTo 속성은 여러 개의 성공 요소를 지정할 수 있지만 일반적으로 읽기 순서에 다음 요소만 포함됩니다. 공급자의 변형 유형: VT_UNKNOWN | VT_ARRAY 클라이언트에 대한 변형 형식: VT_UNKNOWN (IUIAutomationElementArray) 기본값: 빈 배열 |
|
Automation 요소가 속한 기본 UI 프레임워크의 이름을 포함하는 문자열인 FrameworkId 속성을 식별합니다. FrameworkId를 사용하면 클라이언트 애플리케이션이 특정 UI 프레임워크에 따라 자동화 요소를 다르게 처리할 수 있습니다. 속성 값의 예로는 "Win32", "WinForm" 및 "DirectUI"가 있습니다. 변형 유형: VT_BSTR 기본값: 빈 문자열 |
|
FullDescription 속성은 요소에 대한 확장 설명 텍스트를 포함할 수 있는 지역화된 문자열을 노출합니다. FullDescription 은 요소 이름에 적합한 것보다 요소에 대한 보다 완전한 설명을 포함할 수 있습니다. 변형 유형: VT_BSTR 기본값: 빈 문자열 |
|
Automation 요소에 키보드 포커스가 있는지 여부를 나타내는 부울 값인 HasKeyboardFocus 속성을 식별합니다. 변형 유형: VT_BOOL 기본값: FALSE |
|
UI 자동화 요소의 제목 수준을 나타내는 HeadingLevel 속성을 식별합니다. 변형 유형: VT_I4 기본값: HeadingLevel_None |
|
Automation 요소와 연결된 도움말 텍스트 문자열인 HelpText 속성을 식별합니다. HelpText 속성은 편집 또는 목록 컨트롤에 자리 표시자 텍스트가 표시되어 지원될 수 있습니다. 예를 들어 "검색을 위해 여기에 텍스트 입력"은 사용자의 실제 입력 앞에 텍스트를 배치하는 편집 컨트롤의 HelpText 속성에 적합한 후보입니다. 그러나 편집 컨트롤의 name 속성에는 적합하지 않습니다. HelpText가 지원되는 경우 문자열은 애플리케이션 UI 언어 또는 운영 체제 기본 UI 언어와 일치해야 합니다. 변형 유형: VT_BSTR 기본값: 빈 문자열 |
|
요소가 자동화 요소 트리의 콘텐츠 뷰에 표시되는지 여부를 지정하는 부울 값인 IsContentElement 속성을 식별합니다. 자세한 내용은 UI 자동화 트리 개요를 참조하세요. 참고:
|
|
요소가 자동화 요소 트리의 컨트롤 뷰에 표시되는지 여부를 지정하는 부울 값인 IsControlElement 속성을 식별합니다. 자세한 내용은 UI 자동화 트리 개요를 참조하세요. 변형 유형: VT_BOOL 기본값: TRUE |
|
입력하거나 선택한 값이 자동화 요소와 연결된 양식 규칙에 유효한지 여부를 나타내는 부울 값인 IsDataValidForForm 속성을 식별합니다. 예를 들어 사용자가 5자리 또는 9자리가 필요한 우편 번호 필드에 대해 "425-555-5555"를 입력한 경우 IsDataValidForForm 속성을 FALSE 로 설정하여 데이터가 유효하지 않음을 나타낼 수 있습니다. 변형 형식: VT_BOOL 기본값: FALSE |
|
자동화 요소가 대화 상자 창인지 여부를 나타내는 부울 값인 IsDialog 속성을 식별합니다. 예를 들어 화면 읽기 프로그램과 같은 보조 기술은 일반적으로 대화 상자의 제목, 대화 상자의 포커스가 있는 컨트롤, 포커스가 있는 컨트롤까지 대화 내용("닫기 전에 변경 내용을 저장하시겠습니까")을 말합니다. 표준 창의 경우 화면 읽기 프로그램은 일반적으로 창 제목과 포커스가 있는 컨트롤을 말합니다. IsDialog 속성을 TRUE로 설정하여 클라이언트 애플리케이션이 요소를 대화 상자 창으로 처리해야 함을 나타낼 수 있습니다. 변형 형식: VT_BOOL 기본값: FALSE |
|
자동화 요소에서 참조하는 UI 항목이 활성화되어 상호 작용할 수 있는지 여부를 나타내는 부울 값인 IsEnabled 속성을 식별합니다. 컨트롤의 사용 상태가 FALSE이면 자식 컨트롤도 사용하도록 설정되지 않은 것으로 간주됩니다. 부모 컨트롤의 상태가 변경되면 클라이언트는 자식 요소에서 속성 변경 이벤트를 예상해서는 안 됩니다. 변형 형식: VT_BOOL 기본값: FALSE |
|
자동화 요소가 키보드 포커스를 허용할 수 있는지 여부를 나타내는 부울 값인 IsKeyboardFocusable 속성을 식별합니다. 변형 형식: VT_BOOL 기본값: FALSE |
|
자동화 요소가 완전히 보기 밖으로 스크롤되는지(예: 컨테이너 개체의 뷰포트 외부에 있는 목록 상자의 항목) 또는 축소된 보기(예: 트리 뷰 또는 메뉴의 항목 또는 최소화된 창)를 나타내는 부울 값인 IsOffscreen 속성을 식별합니다. 요소에 포커스를 받을 수 있는 클릭 가능한 점이 있는 경우 요소의 일부가 화면 끄기인 동안 요소가 화면에 표시되는 것으로 간주됩니다. 속성의 값 요소가 특정 모니터에 표시 되는지 여부 또는 다른 windows에서 폐색 받지 않습니다. IsOffscreen 속성이 TRUE이면 UI 요소가 화면에서 스크롤되거나 축소됩니다. 요소는 일시적으로 숨겨지지만 최종 사용자의 인식에 남아 있으며 UI 모델에 계속 포함됩니다. 스크롤하고 드롭다운을 클릭하여 개체를 다시 보기로 가져올 수 있습니다. 최종 사용자가 전혀 인식하지 못하거나 "프로그래밍 방식으로 숨겨져 있는" 개체(예: 해제되었지만 기본 개체가 애플리케이션에서 여전히 캐시된 대화 상자)는 처음에 Automation 요소 트리에 없어야 합니다( IsOffscreen 의 상태를 TRUE로 설정하는 대신). 변형 형식: VT_BOOL 기본값: FALSE |
|
자동화 요소에 보호된 콘텐츠 또는 암호가 포함되어 있는지 여부를 나타내는 부울 값인 IsPassword 속성을 식별합니다. IsPassword 속성이 TRUE이고 요소에 키보드 포커스가 있는 경우 클라이언트 애플리케이션은 사용자의 보호된 정보를 노출할 수 있는 키보드 에코 또는 키보드 입력 피드백을 사용하지 않도록 설정해야 합니다. 보호된 요소(편집 컨트롤)의 Value 속성에 액세스하려고 하면 오류가 발생할 수 있습니다. 변형 형식: VT_BOOL 기본값: FALSE |
|
자동화 요소가 주변 장치 UI를 나타내는지 여부를 나타내는 부울 값인 IsPeripheral 속성을 식별합니다. 주변 장치 UI가 나타나고 사용자 상호 작용을 지원하지만 키보드 포커스가 나타나면 사용하지 않습니다. 주변 장치 UI의 예로는 팝업, 플라이아웃, 상황에 맞는 메뉴 또는 부동 알림이 있습니다. Windows 8.1 부터 지원합니다. IsPeripheral 속성이 TRUE인 경우 클라이언트 애플리케이션은 현재 키보드 대화형인 경우에도 요소가 포커스를 가져갔다고 가정할 수 없습니다. 이 속성은 다음 컨트롤 형식과 관련이 있습니다.
기본값: FALSE |
|
양식에서 자동화 요소를 작성해야 하는지 여부를 나타내는 부울 값인 IsRequiredForForm 속성을 식별합니다. 변형 형식: VT_BOOL 기본값: FALSE |
|
Automation 요소 항목의 상태 설명하는 텍스트 문자열인 ItemStatus 속성을 식별합니다. ItemStatus를 사용하면 클라이언트가 요소가 항목에 대한 상태 전달하고 있는지 여부와 상태 무엇인지 확인할 수 있습니다. 예를 들어, "Busy" 또는 "연결 됨" 메시징 애플리케이션에서 대화 상대와 연결 된 항목 수 있습니다. ItemStatus가 지원되는 경우 문자열은 애플리케이션 UI 언어 또는 운영 체제 기본 UI 언어와 일치해야 합니다. 변형 유형: VT_BSTR 기본값: 빈 문자열 |
|
Automation 요소의 형식을 설명하는 텍스트 문자열인 ItemType 속성을 식별합니다. ItemType 은 목록, 트리 뷰 또는 데이터 표의 항목에 대한 정보를 가져오는 데 사용됩니다. 예를 들어 "문서 File" 또는 "폴더" 파일 디렉터리 보기의 항목 수 있습니다. ItemType이 지원되는 경우 문자열은 애플리케이션 UI 언어 또는 운영 체제 기본 UI 언어와 일치해야 합니다. 변형 유형: VT_BSTR 기본값: 빈 문자열 |
|
이 요소의 텍스트 레이블을 포함하는 자동화 요소인 LabeledBy 속성을 식별합니다. 이 속성을 사용하여 콤보 상자의 정적 텍스트 레이블을 검색할 수 있습니다. 변형 형식: VT_UNKNOWN 기본값: NULL |
|
요소와 연결된 랜드마크 형식 식별자인 LandmarkType 속성을 식별합니다. LandmarkType 속성은 요소 그룹을 나타내는 요소를 설명합니다. 예를 들어 검색 랜드마크는 검색을 위한 관련 컨트롤 집합을 나타낼 수 있습니다. UIA_CustomLandmarkTypeId 사용하는 경우 사용자 지정 랜드마크를 설명하는 데 UIA_LocalizedLandmarkTypePropertyId 필요합니다. 변형 형식: VT_I4 기본값: 0 |
|
Automation 요소와 연결된 1 기반 정수인 Level 속성을 식별합니다. Level 속성은 계층 구조 또는 손상된 계층 구조 내에서 요소의 위치를 설명합니다. 예를 들어 글머리 기호/번호 매기기 목록, 머리글 또는 기타 구조화된 데이터 항목에는 다양한 부모/자식 관계가 있을 수 있습니다. 수준은 구조체에서 항목이 있는 위치를 설명합니다. Level과 함께 CustomNavigation 컨트롤 패턴을 사용하는 것이 좋습니다. 변형 형식: VT_I4 기본값: 0 |
|
라이브 지역을 나타내는 자동화 요소에서 지원하는 LiveSetting 속성을 식별합니다. LiveSetting 속성은 클라이언트가 라이브 지역에 대한 변경 내용을 사용자에게 알리는 데 사용해야 하는 "공손성" 수준을 나타냅니다. 이 속성은 LiveSetting 열거형의 값 중 하나일 수 있습니다. Windows 8부터 지원됩니다. 변형 형식: VT_I4 기본값: 0 |
|
Automation 요소가 나타내는 컨트롤의 형식을 설명하는 텍스트 문자열인 LocalizedControlType 속성을 식별합니다. 문자열에는 소문자만 포함되어야 합니다.
LocalizedControlType이 요소 공급자에 의해 지정되지 않은 경우 기본 지역화된 문자열은 요소의 컨트롤 형식(예: 단추 컨트롤 형식의 "단추")에 따라 프레임워크에서 제공됩니다. 사용자 지정 컨트롤 형식의 자동화 요소는 요소의 역할을 나타내는 지역화된 컨트롤 형식 문자열을 지원해야 합니다(예: 사용자가 색을 선택하고 지정할 수 있는 사용자 지정 컨트롤의 경우 "색 선택기"). 사용자 지정 값이 제공되면 문자열이 애플리케이션 UI 언어 또는 운영 체제 기본 UI 언어와 일치해야 합니다. 변형 유형: VT_BSTR 기본값: 빈 문자열 |
|
Automation 요소가 나타내는 랜드마크 유형을 설명하는 텍스트 문자열인 LocalizedLandmarkType을 식별합니다. 이는 UIA_CustomLandmarkTypeId 함께 사용해야 하지만 LocalizedLandmarkType 은 항상 LandmarkType 보다 우선해야 하며 LandmarkType 이전의 랜드마크를 설명하는 데 사용해야 합니다. 문자열은 애플리케이션 UI 언어 또는 운영 체제 기본 UI 언어와 일치해야 합니다. 변형 유형: VT_BSTR 기본값: 빈 문자열 |
|
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 기본값: 빈 문자열 |
|
Automation 요소 창의 핸들(HWND)을 나타내는 정수(있는 경우)인 NativeWindowHandle 속성을 식별합니다. 그렇지 않으면 이 속성은 0입니다. 변형 형식: VT_I4 기본값: 0 |
|
공급자가 표시되는 요소만 노출하는지 여부를 나타내는 부울 값인 OptimizeForVisualContent 속성을 식별합니다. 공급자는 이 속성을 사용하여 매우 큰 콘텐츠로 작업할 때 성능을 최적화할 수 있습니다. 예를 들어 사용자가 큰 콘텐츠를 통해 페이지를 만들면 공급자가 더 이상 표시되지 않는 콘텐츠 요소를 삭제할 수 있습니다. 콘텐츠 요소가 제거되면 공급자는 UIA_E_ELEMENTNOTAVAILABLE 오류 코드를 반환해야 합니다. Windows 8부터 지원됩니다. 변형 형식: VT_BOOL 기본값: FALSE |
|
Automation 요소가 나타내는 컨트롤의 방향을 나타내는 Orientation 속성을 식별합니다. 속성은 OrientationType 열거형 형식의 값으로 표현됩니다. Orientation 속성은 세로 또는 가로 방향을 가질 수 있는 스크롤 막대 및 슬라이더와 같은 컨트롤에서 지원됩니다. 그렇지 않으면 항상 OrientationType_None 수 있습니다. 즉, 컨트롤에 방향이 없습니다. 변형 형식: VT_I4 기본값: 0(OrientationType_None) |
|
Automation 요소의 윤곽선에 사용되는 색을 지정하는 OutlineColor 속성을 식별합니다. 이 특성은 RGB 또는 RGBA 색을 지정하는 데 사용되는 32비트 값인 COLORREF로 지정됩니다. 변형 유형: VT_I4 | VT_ARRAY 기본값: 0 |
|
Automation 요소의 윤곽선에 대한 너비를 지정하는 OutlineThickness 속성을 식별합니다. 변형 형식: VT_R8 | VT_ARRAY 기본값: VT_EMPTY |
|
Automation 요소와 연결된 1 기반 정수인 PositionInSet 속성을 식별합니다. PositionInSet 은 형제로 간주되는 요소 집합 내에서 요소의 서수 위치를 설명합니다. PositionInSet 은 SizeOfSet 속성과 함께 작동하여 집합의 서수 위치를 설명합니다. 변형 형식: VT_I4 기본값: 0 |
|
Automation 요소의 프로세스 식별자(ID)를 나타내는 정수인 ProcessId 속성을 식별합니다. 프로세스 식별자(ID)는 운영 체제에 의해 할당됩니다. 볼 수 있습니다는 PID 열을 프로세스 작업 관리자의 탭 합니다. 변형 형식: VT_I4 기본값: 0 |
|
프록시 정보를 포함하여 자동화 요소에 대한 UI 자동화 공급자의 원본 정보를 포함하는 형식이 지정된 문자열인 ProviderDescription 속성을 식별합니다. 변형 유형: VT_BSTR 기본값: 빈 문자열 |
|
회전 각도를 지정하지 않은 단위로 지정하는 Rotation 속성을 식별합니다. 변형 형식: VT_R8 기본값: 0 |
|
Automation 요소의 식별자를 나타내는 정수 배열인 RuntimeId 속성을 식별합니다. 식별자는 데스크톱에서 고유하지만 생성된 데스크톱의 UI 내에서만 고유하도록 보장됩니다. 시간이 지남에 따라 식별자를 재사용할 수 있습니다. RuntimeId의 형식은 변경할 수 있습니다. 반환된 식별자는 불투명 값으로 처리되고 비교에만 사용해야 합니다. 예를 들어 자동화 요소가 캐시에 있는지 여부를 확인합니다. 변형 유형: VT_I4 | VT_ARRAY 기본값: VT_EMPTY |
|
Automation 요소의 너비와 높이를 지정하는 Size 속성을 식별합니다. 변형 형식: VT_R8 | VT_ARRAY 기본값: VT_EMPTY |
|
Automation 요소와 연결된 1 기반 정수인 SizeOfSet 속성을 식별합니다. SizeOfSet 은 형제로 간주되는 그룹 또는 집합의 자동화 요소 수를 설명합니다. SizeOfSet 은 PositionInSet 속성과 함께 작동하여 집합의 항목 수를 설명합니다. 변형 형식: VT_I4 기본값: 0 |
|
그림자, 반사, 네온, 부드러운 가장자리 또는 경사와 같은 자동화 요소에 대한 효과를 지정하는 비트 필드인 VisualEffects 속성을 식별합니다. VisualEffects:
기본값: 0 |
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows XP [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 |
Windows Server 2003 [데스크톱 앱 | UWP 앱] |
| 헤더 |
|
추가 정보
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기