UiaAddEvent 함수(uiautomationcoreapi.h)
구문
HRESULT UiaAddEvent(
[in] HUIANODE hnode,
[in] EVENTID eventId,
[in] UiaEventCallback *pCallback,
[in] TreeScope scope,
[in] PROPERTYID *pProperties,
[in] int cProperties,
[in] UiaCacheRequest *pRequest,
[out] HUIAEVENT *phEvent
);
매개 변수
[in] hnode
형식: HUIANODE
이벤트 수신기를 추가할 노드입니다.
[in] eventId
형식: EVENTID
수신 대기할 이벤트의 식별자입니다. 이벤트 ID 목록은 이벤트 식별자를 참조하세요.
[in] pCallback
형식: UiaEventCallback*
이벤트가 발생할 때 호출되는 애플리케이션 정의 UiaEventCallback 콜백 함수의 주소입니다.
[in] scope
형식: TreeScope*
처리할 이벤트의 scope 나타내는 TreeScope 열거형 형식의 값입니다. 즉, 요소 자체에 있는지 또는 상위 항목과 자식에 있는지 여부입니다.
[in] pProperties
형식: PROPERTYID*
eventId가 AutomationPropertyChanged_Event_GUID 파생된 EVENTID 인 경우 변경 이벤트를 모니터링할 속성의 식별자를 포함하는 배열의 주소입니다. 그렇지 않으면 이 매개 변수가 NULL입니다. 속성 ID 목록은 속성 식별자를 참조하세요.
[in] cProperties
형식: int
pProperties 배열의 요소 수입니다.
[in] pRequest
형식: UiaCacheRequest*
이벤트와 함께 반환되는 노드에 대해 적용되는 캐시 요청을 정의하는 UiaCacheRequest 구조체의 주소입니다.
[out] phEvent
형식: HUIEVENT*
이 함수가 반환되면 가 추가되는 이벤트에 대한 포인터를 포함합니다. 이 매개 변수는 초기화되지 않은 상태로 전달됩니다.
반환 값
형식: HRESULT
성공하면 S_OK 반환하고, 그렇지 않으면 오류 값을 반환합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | uiautomationcoreapi.h |
| 라이브러리 | Uiautomationcore.lib |
| DLL | Uiautomationcore.dll |