Bagikan melalui

Fungsi UiaFind (uiautomationcoreapi.h)

  • Artikel
Catatan Fungsi ini tidak digunakan lagi. Aplikasi klien harus menggunakan antarmuka Microsoft UI Automation Component Object Model (COM).
 
Mengambil satu atau beberapa simpul Automation UI yang cocok dengan kriteria pencarian.

Sintaks

HRESULT UiaFind(
  [in]  HUIANODE        hnode,
  [in]  UiaFindParams   *pParams,
  [in]  UiaCacheRequest *pRequest,
  [out] SAFEARRAY       **ppRequestedData,
  [out] SAFEARRAY       **ppOffsets,
  [out] SAFEARRAY       **ppTreeStructures
);

Parameter

[in] hnode

Jenis: HUIANODE

Simpul yang digunakan sebagai titik awal pencarian.

[in] pParams

Jenis: UiaFindParams*

Alamat struktur UiaFindParams yang berisi parameter pencarian.

[in] pRequest

Jenis: UiaCacheRequest*

Alamat struktur UiaCacheRequest yang menentukan informasi apa yang akan di-cache.

[out] ppRequestedData

Jenis: SAFEARRAY**

Alamat variabel yang menerima pointer ke SAFEARRAY yang berisi data yang diminta. Parameter ini diteruskan tanpa diinisialisasi. Lihat Keterangan.

[out] ppOffsets

Jenis: SAFEARRAY**

Alamat variabel yang menerima pointer ke SAFEARRAY yang berisi indeks ke array data yang diminta tempat subtree elemen dimulai. Parameter ini diteruskan tanpa diinisialisasi.

[out] ppTreeStructures

Jenis: SAFEARRAY**

Alamat variabel yang menerima pointer ke SAFEARRAY yang berisi deskripsi struktur pohon. Parameter ini diteruskan tanpa diinisialisasi. Lihat Keterangan.

Nilai kembali

Jenis: HRESULT

Mengembalikan S_OK jika berhasil atau nilai kesalahan sebaliknya.

Keterangan

Struktur pohon dijelaskan oleh string di mana setiap karakter adalah "p" atau ")". Karakter pertama dalam string selalu mewakili simpul akar. String adalah NULL jika tidak ada elemen yang dikembalikan oleh fungsi .

"p" mewakili node (elemen Automation UI). Ketika satu "p" langsung mengikuti yang lain, simpul kedua adalah anak dari yang pertama. A ")" mewakili langkah mencadangkan pohon. Misalnya, "pp)p" mewakili simpul yang diikuti oleh dua simpul anak yang merupakan saudara kandung satu sama lain. Dalam "pp))p", simpul terakhir adalah saudara kandung dari simpul pertama.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header uiautomationcoreapi.h
Pustaka Uiautomationcore.lib
DLL Uiautomationcore.dll