IItemContainerProvider::FindItemByProperty 메서드(uiautomationcore.h)

지정된 속성 값에 따라 포함하는 요소 내의 요소를 검색합니다.

구문

HRESULT FindItemByProperty(
  [in]  IRawElementProviderSimple *pStartAfter,
  [in]  PROPERTYID                propertyId,
  [in]  VARIANT                   value,
  [out] IRawElementProviderSimple **pFound
);

매개 변수

[in] pStartAfter

형식: IRawElementProviderSimple*

검색이 시작된 후 요소의 UI 자동화 공급자이거나 모든 요소를 검색할 NULL입니다.

[in] propertyId

형식: PROPERTYID

속성 식별자입니다. 속성 ID 목록은 속성 식별자를 참조하세요.

[in] value

형식: VARIANT

속성 값입니다.

[out] pFound

형식: IRawElementProviderSimple**

요소의 UI 자동화 공급자에 대한 포인터를 받습니다.

반환 값

형식: HRESULT

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

설명

가상 목록의 경우 반환된 요소는 자리 표시자일 수 있습니다. 그런 다음 IVirtualizedItemProvider::Realize 를 사용하여 항목을 완전히 사용할 수 있도록 할 수 있습니다.

지정된 속성으로 검색할 수 없는 경우 메서드는 E_INVALIDARG 반환합니다. 대부분의 컨테이너는 UIA_NamePropertyId 지원해야 하며, 적절한 경우 UIA_AutomationIdPropertyId 및 UIA_SelectionItemIsSelectedPropertyId 지원해야 합니다.

propertyId가 0이면 모든 항목이 일치합니다. 이 값은 pStartAfter 같음 NULL 과 함께 사용하여 첫 번째 항목을 가져와 연속 항목을 가져올 수 있습니다. 이 경우 값 은 VT_EMPTY 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7, Windows Vista SP2 및 Windows Vista용 플랫폼 업데이트, WINDOWS XP SP3 및 Windows Vista용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2008 R2, Windows Server 2008 SP2 및 Windows Server 2008용 플랫폼 업데이트, WINDOWS Server 2003 SP2 및 Windows Server 2008용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	uiautomationcore.h(UIAutomation.h 포함)
DLL	Uiautomationcore.dll

추가 정보

개념

IItemContainerProvider

속성 식별자

참조