UiaNavigate 함수(uiautomationcoreapi.h)

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

 

선택적으로 캐시된 정보를 검색하여 UI 자동화 트리에서 이동합니다.

구문

HRESULT UiaNavigate(
  [in]  HUIANODE          hnode,
  [in]  NavigateDirection direction,
  [in]  UiaCondition      *pCondition,
  [in]  UiaCacheRequest   *pRequest,
  [out] SAFEARRAY         **ppRequestedData,
  [out] BSTR              *ppTreeStructure
);

매개 변수

[in] hnode

형식: HUIANODE

탐색이 시작되는 요소입니다.

[in] direction

형식: NavigateDirection

hnode에서 탐색할 방향을 나타내는 NavigateDirection 열거형 형식의 값입니다.

[in] pCondition

형식: UiaCondition*

탐색할 요소가 일치해야 하는 조건을 지정하는 UiaCondition 구조체의 주소입니다. 이 매개 변수를 사용하여 관심 없는 요소를 건너뜁니다.

[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