IItemContainerProvider：：FindItemByProperty 方法 (uiautomationcore.h)

  • 發行項

根據指定的屬性值，擷取包含專案內的專案。

語法

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

參數

[in] pStartAfter

類型： IRawElementProviderSimple*

元素的 使用者介面自動化 提供者，搜尋開始之後，或 NULL 來搜尋所有元素。

[in] propertyId

類型： PROPERTYID

屬性識別項。 如需屬性識別碼的清單，請參閱 屬性標識碼。

[in] value

類型： VARIANT

屬性的值。

[out] pFound

類型： IRawElementProviderSimple**

接收專案的 使用者介面自動化 提供者指標。

傳回值

類型： 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 和 Platform Update for Windows Server 2008、Windows Server 2003 SP2 和 Platform Update for Windows Server 2008 [桌面應用程式 |UWP 應用程式]
目標平台 Windows
標頭 uiautomationcore.h (包含 UIAutomation.h)
Dll Uiautomationcore.dll

另請參閱

概念

IItemContainerProvider

屬性識別項

參考