Share via


CUIAutomation 개체 만들기

이 섹션에서는 IUIAutomation을 구현하는 개체를 인스턴스화하여 Microsoft UI 자동화 클라이언트 애플리케이션 작성을 시작하는 방법을 설명합니다.

이 항목에는 다음과 같은 섹션이 포함되어 있습니다.

CUIAutomation 개체

UI 자동화 사용하는 첫 번째 단계는 CUIAutomation 클래스의 개체를 만드는 것입니다. 이 개체는 클라이언트 애플리케이션에서 사용하는 다른 모든 개체 및 인터페이스에 대한 게이트웨이인 IUIAutomation 인터페이스를 노출합니다. 무엇보다도 IUIAutomation 은 다음 작업에 사용됩니다.

  • 이벤트 구독.
  • 조건 만들기. 조건은 UI 자동화 요소에 대한 검색의 scope 좁히는 데 사용되는 개체입니다.
  • 바탕 화면(루트 요소) 또는 화면 좌표 또는 창 핸들에서 직접 UI 자동화 요소를 가져옵니다.
  • UI 자동화 요소의 계층 구조를 탐색하는 데 사용할 수 있는 트리 워커 개체를 만듭니다.
  • 데이터 형식 변환

개체 만들기

애플리케이션에서 UI 자동화 사용을 시작하려면 다음 단계를 수행합니다.

  • 프로젝트 헤더에 UIAutomation.h를 포함합니다. UIAutomation.h는 API를 정의하는 다른 헤더를 제공합니다.
  • IUIAutomation에 대한 포인터를 선언합니다.
  • COM(구성 요소 개체 모델)을 초기화합니다.
  • CUIAutomation의 instance 만들고 포인터에서 IUIAutomation 인터페이스를 검색합니다.

다음 예제 함수는 COM을 초기화한 다음 CUIAutomation 개체를 만들어 ppAutomation 포인터에서 IUIAutomation 인터페이스를 검색 합니다 .

#include <uiautomation.h>

// CoInitialize must be called before calling this function, and the  
// caller must release the returned pointer when finished with it.
// 
HRESULT InitializeUIAutomation(IUIAutomation **ppAutomation)
{
    return CoCreateInstance(CLSID_CUIAutomation, NULL,
        CLSCTX_INPROC_SERVER, IID_IUIAutomation, 
        reinterpret_cast<void**>(ppAutomation));
}

개념

UI 자동화 이벤트 개요

UI 자동화 요소 가져오기