IUIAutomationItemContainerPattern::FindItemByProperty 메서드(uiautomationclient.h)

지정된 속성 값을 기반으로 포함하는 요소 내의 요소를 검색합니다.

구문

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

매개 변수

[in] pStartAfter

형식: IUIAutomationElement*

검색이 시작된 후 요소에 대한 포인터이거나 모든 요소를 검색하는 NULL 입니다.

[in] propertyId

형식: PROPERTYID

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

[in] value

형식: VARIANT

속성 값입니다.

[out, retval] pFound

형식: IUIAutomationElement**

일치하는 요소에 대한 포인터를 받습니다.

반환 값

형식: HRESULT

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

설명

일치하는 요소가 가상화된 경우 공급자는 실제 IUIAutomationElement 인터페이스 또는 자리 표시자를 반환할 수 있습니다.

요청된 속성이 컨테이너에서 검색을 지원하는 속성이 아닌 경우 이 메서드는 E_INVALIDARG 반환합니다. 대부분의 컨테이너는 Name 속성을 지원하고 컨테이너에 적합한 경우 AutomationId 및 IsSelected를 지원할 것으로 예상됩니다.

이 메서드는 일치하는 개체를 찾기 위해 여러 개체를 트래버스해야 할 수 있으므로 속도가 느릴 수 있습니다. 루프에서 여러 항목을 반환하는 데 사용할 경우 각 항목이 한 번만 반환되는 한 특정 순서가 정의되지 않습니다(즉, 루프가 종료되어야 합니다). 또한 이 메서드는 UI 중심이 아닌 항목 중심이므로 여러 UI 표현이 있는 항목은 한 번만 적중해야 합니다.

propertyId 매개 변수가 0으로 지정되면 공급자는 pStartAfter 다음에 다음 항목을 반환해야 합니다. pStartAfter가 propertyId가 0인 NULL로 지정된 경우 공급자는 컨테이너의 첫 번째 항목을 반환해야 합니다. propertyId를 0으로 지정하면 값 매개 변수를 VT_EMPTY 합니다.

요구 사항

추가 정보

IUIAutomationItemContainerPattern

실현

참조