IUIAutomationTreeWalker::NormalizeElementBuildCache 메서드(uiautomationclient.h)

트리 뷰에서 지정된 Microsoft UI Automation 요소에 가장 가까운 상위 요소를 검색하고, 요청된 속성 및 컨트롤 패턴을 미리 몰수하고, 프리페치된 항목을 캐시에 저장합니다.

구문

HRESULT NormalizeElementBuildCache(
  [in]          IUIAutomationElement      *element,
  [in]          IUIAutomationCacheRequest *cacheRequest,
  [out, retval] IUIAutomationElement      **normalized
);

매개 변수

[in] element

형식: IUIAutomationElement*

정규화를 시작할 요소에 대한 포인터입니다.

[in] cacheRequest

형식: IUIAutomationCacheRequest*

반환된 요소에서 캐시할 속성 및 컨트롤 패턴을 지정하는 캐시 요청에 대한 포인터입니다.

[out, retval] normalized

형식: IUIAutomationElement**

트리 뷰에서 지정된 요소에 가장 가까운 상위 요소에 대한 포인터를 받습니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

요소는 뷰 조건을 충족하는 요소( IUIAutomationTreeWalker::Condition에 대한 이전 호출로 지정됨)에 도달할 때까지 트리에서 상위 체인을 탐색하여 정규화됩니다. 루트 요소에 도달하면 루트 요소가 뷰 조건을 충족하지 않더라도 반환됩니다.

이 메서드는 적중 테스트를 통해 UI 자동화 요소에 대한 참조를 가져오는 애플리케이션에 유용합니다. 애플리케이션은 특정 유형의 요소에서만 작동할 수 있으며 IUIAutomationTreeWalker::NormalizeElement 를 사용하여 처음에 검색된 요소(예: 스크롤 막대가 입력 포커스를 가져오는 경우)에 관계없이 관심 있는 요소(예: 콘텐츠 요소)만 궁극적으로 검색되도록 할 수 있습니다.

요구 사항

지원되는 최소 클라이언트	Windows 7, WINDOWS Vista SP2 및 Windows Vista용 플랫폼 업데이트, WINDOWS XP SP3 및 Windows Vista용 플랫폼 업데이트 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 R2, Windows Server 2008 SP2 및 Windows Server 2008용 플랫폼 업데이트, Windows Server 2003 SP2 및 Windows Server 2008용 플랫폼 업데이트 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	uiautomationclient.h(UIAutomation.h 포함)