Metode IItemContainerProvider::FindItemByProperty (uiautomationcore.h)

Mengambil elemen dalam elemen yang berisi, berdasarkan nilai properti tertentu.

Sintaks

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

Parameter

[in] pStartAfter

Jenis: IRawElementProviderSimple*

Penyedia Otomatisasi UI elemen setelah pencarian dimulai, atau NULL untuk mencari semua elemen.

[in] propertyId

Jenis: PROPERTYID

Pengidentifikasi properti. Untuk daftar ID properti, lihat Pengidentifikasi Properti.

[in] value

Jenis: VARIAN

Nilai properti .

[out] pFound

Jenis: IRawElementProviderSimple**

Menerima penunjuk ke penyedia Automation UI elemen.

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Untuk daftar virtual, elemen yang dikembalikan mungkin tempat penampung. IVirtualizedItemProvider::Real kemudian dapat digunakan untuk membuat item sepenuhnya tersedia.

Metode mengembalikan E_INVALIDARG jika pencarian oleh properti yang ditentukan tidak didukung. Sebagian besar kontainer harus mendukung UIA_NamePropertyId dan, jika sesuai, UIA_AutomationIdPropertyId dan UIA_SelectionItemIsSelectedPropertyId.

Jika propertyId adalah 0, semua item cocok. Nilai ini dapat digunakan dengan pStartAfter yang sama dengan NULL untuk mendapatkan item pertama, lalu untuk mendapatkan item berturut-turut. Dalam hal ini, nilai harus VT_EMPTY.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7, Windows Vista dengan SP2 dan Pembaruan Platform untuk Windows Vista, Windows XP dengan SP3 dan Pembaruan Platform untuk Windows Vista [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 R2, Windows Server 2008 dengan SP2 dan Pembaruan Platform untuk Windows Server 2008, Windows Server 2003 dengan SP2 dan Pembaruan Platform untuk Windows Server 2008 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	uiautomationcore.h (termasuk UIAutomation.h)
DLL	Uiautomationcore.dll

Lihat juga

Konseptual

IItemContainerProvider

Pengidentifikasi Properti

Referensi