UiaNodeFromFocus 함수(uiautomationcoreapi.h)

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

 

현재 입력 포커스가 있는 UI 요소의 UI 자동화 노드를 검색합니다.

구문

HRESULT UiaNodeFromFocus(
  [in]  UiaCacheRequest *pRequest,
  [out] SAFEARRAY       **ppRequestedData,
  [out] BSTR            *ppTreeStructure
);

매개 변수

[in] pRequest

형식: UiaCacheRequest*

캐시할 데이터에 대한 정보를 포함하는 UiaCacheRequest 구조체의 주소입니다.

[out] ppRequestedData

형식: SAFEARRAY**

요청된 정보를 포함하는 SAFEARRAY 에 대한 포인터를 수신하는 변수의 주소입니다. 이 매개 변수는 초기화되지 않은 상태로 전달됩니다.

[out] ppTreeStructure

형식: BSTR*

트리 구조에 대한 설명을 수신하는 변수의 주소입니다. 이 매개 변수는 초기화되지 않은 상태로 전달됩니다. 설명 부분을 참조하세요.

반환 값

형식: HRESULT

성공하면 S_OK 반환하고 그렇지 않으면 오류 값을 반환합니다.

설명

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

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

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	uiautomationcoreapi.h
라이브러리	Uiautomationcore.lib
DLL	Uiautomationcore.dll