IUIAutomation 인터페이스(uiautomationclient.h)
Microsoft UI 자동화 클라이언트 애플리케이션이 UI 자동화 요소를 검색, 액세스 및 필터링할 수 있도록 하는 메서드를 노출합니다. UI 자동화 UI 자동화 모든 요소를 IUIAutomation 인터페이스가 나타내는 개체로 노출합니다. 이 인터페이스의 멤버는 특정 요소에만 해당되지 않습니다.
상속
IUIAutomation 인터페이스는 IUnknown 인터페이스에서 상속됩니다. IUIAutomation 에는 다음과 같은 유형의 멤버도 있습니다.
메서드
IUIAutomation 인터페이스에는 이러한 메서드가 있습니다.
| IUIAutomation::AddAutomationEventHandler Microsoft UI 자동화 이벤트를 처리하는 메서드를 등록합니다. 참고 이벤트 처리기를 구현하기 전에 스레딩 문제 이해에 설명된 스레딩 문제를 잘 알고 있어야 합니다. |
| IUIAutomation::AddFocusChangedEventHandler 포커스 변경 이벤트를 처리하는 메서드를 등록합니다. 참고 이벤트 처리기를 구현하기 전에 스레딩 문제 이해에 설명된 스레딩 문제를 잘 알고 있어야 합니다. |
| IUIAutomation::AddPropertyChangedEventHandler 속성 변경 이벤트의 및 배열을 처리하는 메서드를 등록합니다. |
| IUIAutomation::AddPropertyChangedEventHandlerNativeArray 속성 변경 이벤트의 네이티브 배열을 처리하는 메서드를 등록합니다. |
| IUIAutomation::AddStructureChangedEventHandler 구조 변경 이벤트를 처리하는 메서드를 등록합니다. 참고 이벤트 처리기를 구현하기 전에 스레딩 문제 이해에 설명된 스레딩 문제를 잘 알고 있어야 합니다. |
| IUIAutomation::CheckNotSupported 제공된 VARIANT를 검사하여 지원되지 않는 식별자가 포함되어 있는지 확인합니다. |
| IUIAutomation::CompareElements 두 UI 자동화 요소를 비교하여 동일한 기본 UI 요소를 나타내는지 여부를 확인합니다. |
| IUIAutomation::CompareRuntimeIds ID(런타임 식별자)가 포함된 두 정수 배열을 비교하여 해당 콘텐츠가 동일하고 동일한 UI 요소에 속하는지 여부를 확인합니다. |
| IUIAutomation::CreateAndCondition 두 조건 모두와 일치하는 요소를 선택하는 조건을 만듭니다. |
| IUIAutomation::CreateAndConditionFromArray 여러 조건에 따라 요소를 선택하는 조건을 만듭니다. 모두 true여야 합니다. |
| IUIAutomation::CreateAndConditionFromNativeArray 모두 true여야 하는 여러 조건에 따라 네이티브 배열에서 요소를 선택하는 조건을 만듭니다. |
| IUIAutomation::CreateCacheRequest 캐시 요청을 만듭니다. |
| IUIAutomation::CreateFalseCondition 항상 false인 조건을 만듭니다. |
| IUIAutomation::CreateNotCondition 지정된 조건의 음수인 조건을 만듭니다. |
| IUIAutomation::CreateOrCondition 조건 중 하나가 true인 경우 일치 항목이 있는 두 조건의 조합을 만듭니다. |
| IUIAutomation::CreateOrConditionFromArray 조건이 true인 경우 일치 항목이 있는 두 개 이상의 조건 조합을 만듭니다. |
| IUIAutomation::CreateOrConditionFromNativeArray 조건 중 하나가 true인 경우 일치 항목이 있는 두 개 이상의 조건 조합을 만듭니다. |
| IUIAutomation::CreatePropertyCondition 지정된 값을 가진 속성이 있는 요소를 선택하는 조건을 만듭니다. |
| IUIAutomation::CreatePropertyConditionEx 선택적 플래그를 사용하여 지정된 값을 가진 속성이 있는 요소를 선택하는 조건을 만듭니다. |
| IUIAutomation::CreateProxyFactoryEntry 프록시 팩터리 개체의 새 instance 만듭니다. |
| IUIAutomation::CreateTreeWalker Microsoft UI 자동화 트리를 트래버스하는 데 사용할 수 있는 트리 워커 개체를 검색합니다. |
| IUIAutomation::CreateTrueCondition 모든 요소를 선택하는 미리 정의된 조건을 검색합니다. |
| IUIAutomation::ElementFromHandle 지정된 창에 대한 UI 자동화 요소를 검색합니다. |
| IUIAutomation::ElementFromHandleBuildCache 지정된 창에 대한 UI 자동화 요소를 검색하고, 요청된 속성 및 컨트롤 패턴을 프리페치하고, 프리페치된 항목을 캐시에 저장합니다. |
| IUIAutomation::ElementFromIAccessible Microsoft Active Accessibility 서버에서 지정된 액세스 가능한 개체에 대한 UI 자동화 요소를 검색합니다. |
| IUIAutomation::ElementFromIAccessibleBuildCache Microsoft Active Accessibility 서버에서 지정된 액세스 가능한 개체에 대한 UI 자동화 요소를 검색하고, 요청된 속성 및 컨트롤 패턴을 프리페치하고, 프리페치된 항목을 캐시에 저장합니다. |
| IUIAutomation::ElementFromPoint 바탕 화면의 지정된 지점에서 UI 자동화 요소를 검색합니다. |
| IUIAutomation::ElementFromPointBuildCache 바탕 화면의 지정된 지점에서 UI 자동화 요소를 검색하고, 요청된 속성 및 컨트롤 패턴을 프리페치하고, 프리페치된 항목을 캐시에 저장합니다. |
| IUIAutomation::get_ContentViewCondition 콘텐츠 요소를 선택하는 미리 정의된 IUIAutomationCondition 인터페이스를 검색합니다. |
| IUIAutomation::get_ContentViewWalker 콘텐츠 요소를 검색하는 데 사용되는 IUIAutomationTreeWalker 인터페이스를 검색합니다. |
| IUIAutomation::get_ControlViewCondition 컨트롤 요소를 선택하는 미리 정의된 IUIAutomationCondition 인터페이스를 검색합니다. |
| IUIAutomation::get_ControlViewWalker 컨트롤 요소를 검색하는 데 사용되는 IUIAutomationTreeWalker 인터페이스를 검색합니다. |
| IUIAutomation::get_ProxyFactoryMapping Window 클래스 이름 및 연결된 데이터를 개별 프록시 팩터리에 매핑하는 것을 나타내는 개체를 검색합니다. |
| IUIAutomation::get_RawViewCondition 필터링되지 않은 보기에서 모든 UI 요소를 선택하는 미리 정의된 IUIAutomationCondition 인터페이스를 검색합니다. |
| IUIAutomation::get_RawViewWalker Microsoft UI 자동화 트리의 필터링되지 않은 보기를 트래버스하는 데 사용되는 트리 워커 개체를 검색합니다. |
| IUIAutomation::get_ReservedMixedAttributeValue 혼합 특성인 텍스트 특성을 나타내는 정적 토큰 개체를 검색합니다. |
| IUIAutomation::get_ReservedNotSupportedValue 지원되지 않는 속성 또는 텍스트 특성을 나타내는 정적 토큰 개체를 검색합니다. |
| IUIAutomation::GetFocusedElement 입력 포커스가 있는 UI 자동화 요소를 검색합니다. |
| IUIAutomation::GetFocusedElementBuildCache 입력 포커스가 있는 UI 자동화 요소를 검색하고, 요청된 속성 및 컨트롤 패턴을 프리페치하고, 프리페치된 항목을 캐시에 저장합니다. |
| IUIAutomation::GetPatternProgrammaticName 컨트롤 패턴의 등록된 프로그래밍 이름을 검색합니다. |
| IUIAutomation::GetPropertyProgrammaticName 속성의 등록된 프로그래밍 이름을 검색합니다. |
| IUIAutomation::GetRootElement 바탕 화면을 나타내는 UI 자동화 요소를 검색합니다. |
| IUIAutomation::GetRootElementBuildCache 바탕 화면을 나타내는 UI 자동화 요소를 검색하고, 요청된 속성 및 컨트롤 패턴을 프리페치하고, 프리페치된 항목을 캐시에 저장합니다. |
| IUIAutomation::IntNativeArrayToSafeArray 정수 배열을 SAFEARRAY로 변환합니다. |
| IUIAutomation::IntSafeArrayToNativeArray 정수의 SAFEARRAY를 배열로 변환합니다. |
| IUIAutomation::P ForPotentialSupportedPatterns UI 자동화 요소에서 지원될 수 있는 컨트롤 패턴을 검색합니다. |
| IUIAutomation::P forPotentialSupportedProperties UI 자동화 요소에서 지원될 수 있는 속성을 검색합니다. |
| IUIAutomation::RectToVariant 사각형의 좌표를 포함하는 VARIANT를 만듭니다. |
| IUIAutomation::RemoveAllEventHandlers 등록된 모든 Microsoft UI 자동화 이벤트 처리기를 제거합니다. |
| IUIAutomation::RemoveAutomationEventHandler 지정된 UI 자동화 이벤트 처리기를 제거합니다. |
| IUIAutomation::RemoveFocusChangedEventHandler 포커스가 변경된 이벤트 처리기를 제거합니다. |
| IUIAutomation::RemovePropertyChangedEventHandler 속성 변경 이벤트 처리기를 제거합니다. |
| IUIAutomation::RemoveStructureChangedEventHandler 구조 변경 이벤트 처리기를 제거합니다. |
| IUIAutomation::SafeArrayToRectNativeArray 사각형 좌표가 포함된 SAFEARRAY를 RECT 형식의 배열로 변환합니다. |
| IUIAutomation::VariantToRect 사각형 좌표를 포함하는 VARIANT를 RECT로 변환합니다. |
설명
모든 UI 자동화 클라이언트 애플리케이션은 UI 자동화 기능에 액세스하려면 CUIAutomation 개체에 대한 이 인터페이스를 가져와야 합니다.
다음 예제 함수는 CUIAutomation 개체를 만들고 IUIAutomation 인터페이스를 가져옵니다.
IUIAutomation *g_pAutomation;
BOOL InitializeUIAutomation()
{
CoInitialize(NULL);
HRESULT hr = CoCreateInstance(__uuidof(CUIAutomation), NULL, CLSCTX_INPROC_SERVER,
__uuidof(IUIAutomation), (void**)&g_pAutomation);
return (SUCCEEDED(hr));
}
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 7, WINDOWS Vista SP2 및 Windows Vista용 플랫폼 업데이트, WINDOWS XP SP3 및 Windows Vista용 플랫폼 업데이트 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 R2, Windows Server 2008 SP2 및 Windows Server 2008용 플랫폼 업데이트, Windows Server 2003 SP2 및 Windows Server 2008용 플랫폼 업데이트 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | uiautomationclient.h(UIAutomation.h 포함) |