UiaEventCallback 콜백 함수(uiautomationcoreapi.h)

참고 이 함수는 더 이상 사용되지 않습니다. 클라이언트 애플리케이션은 Microsoft UI 자동화 COM(구성 요소 개체 모델) 인터페이스를 대신 사용해야 합니다.

 

클라이언트가 구독한 이벤트가 발생할 때 UI 자동화에서 호출되는 클라이언트 구현 함수입니다.

구문

UiaEventCallback Uiaeventcallback;

void Uiaeventcallback(
  [in] UiaEventArgs *pArgs,
  [in] SAFEARRAY *pRequestedData,
  [in] BSTR pTreeStructure
)
{...}

매개 변수

[in] pArgs

형식: UiaEventArgs*

이벤트 인수를 포함하는 UiaEventArgs 구조체의 주소입니다.

[in] pRequestedData

형식: SAFEARRAY*

이벤트와 연결된 데이터를 포함하는 SAFEARRAY 입니다.

[in] pTreeStructure

형식: BSTR

이벤트가 노드 집합과 연결된 경우 이벤트와 연결된 트리의 구조를 포함하는 문자열입니다. 설명 부분을 참조하세요.

반환 값

없음

설명

이 함수는 UiaAddEvent 및 UiaRemoveEvent에 전달됩니다.

트리 구조는 모든 문자가 "p" 또는 ")"인 문자열로 설명됩니다. 문자열의 첫 번째 문자는 항상 루트 노드를 나타냅니다. 함수에서 반환되는 요소가 없는 경우 문자열은 NULL 입니다.

"p"는 노드(UI 자동화 요소)를 나타냅니다. 한 "p"가 다른 노드를 직접 따르는 경우 두 번째 노드는 첫 번째 노드의 자식입니다. ")"는 트리를 백업하는 단계를 나타냅니다. 예를 들어 "pp)p"는 노드 뒤에 서로 형제인 두 자식 노드를 나타냅니다. "pp))p"에서 마지막 노드는 첫 번째 노드의 형제입니다.

요구 사항

지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	uiautomationcoreapi.h