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 포함)

추가 정보

클라이언트에 대한 UI 자동화 요소 인터페이스