UiaNodeFromPoint 함수(uiautomationcoreapi.h)
참고 이 함수는 더 이상 사용되지 않습니다. 클라이언트 애플리케이션은 Microsoft UI 자동화 COM(구성 요소 개체 모델) 인터페이스를 대신 사용해야 합니다.
구문
HRESULT UiaNodeFromPoint(
[in] double x,
[in] double y,
[in] UiaCacheRequest *pRequest,
[out] SAFEARRAY **ppRequestedData,
[out] BSTR *ppTreeStructure
);
매개 변수
[in] x
형식: double
점의 가로 좌표입니다.
[in] y
형식: double
점의 세로 좌표입니다.
[in] pRequest
형식: UiaCacheRequest*
클라이언트의 정보에 대한 캐시 요청을 포함하는 UiaCacheRequest 구조체의 주소입니다.
[out] ppRequestedData
형식: SAFEARRAY**
요청된 데이터가 포함된 SAFEARRAY 에 대한 포인터를 수신하는 변수의 주소입니다. 이 매개 변수는 초기화되지 않은 상태로 전달됩니다.
[out] ppTreeStructure
형식: BSTR*
트리 구조에 대한 설명을 수신하는 변수의 주소입니다. 이 매개 변수는 초기화되지 않은 상태로 전달됩니다. 설명 부분을 참조하세요.
반환 값
형식: HRESULT
성공하면 S_OK 반환하고 그렇지 않으면 오류 값을 반환합니다.
설명
반환되는 요소는 지정된 조건과 일치하는 UI 자동화 트리 구조에서 가장 가까운 요소가 됩니다.
트리 구조는 모든 문자가 "p" 또는 ")"인 문자열로 설명됩니다. 문자열의 첫 번째 문자는 항상 루트 노드를 나타냅니다. 함수에서 반환되는 요소가 없는 경우 문자열은 NULL 입니다.
"p"는 노드(UI 자동화 요소)를 나타냅니다. 한 "p"가 다른 노드를 직접 따르는 경우 두 번째 노드는 첫 번째 노드의 자식입니다. ")"는 트리를 백업하는 단계를 나타냅니다. 예를 들어 "pp)p"는 노드 뒤에 서로 형제인 두 자식 노드를 나타냅니다. "pp))p"에서 마지막 노드는 첫 번째 노드의 형제입니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | uiautomationcoreapi.h |
| 라이브러리 | Uiautomationcore.lib |
| DLL | Uiautomationcore.dll |