共用方式為


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_AutomationIdPropertyIdUIA_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

屬性識別項

參考