Fungsi UiaNodeFromPoint (uiautomationcoreapi.h)

Catatan Fungsi ini tidak digunakan lagi. Aplikasi klien harus menggunakan antarmuka Microsoft UI Automation Component Object Model (COM).

 

Mengambil simpul Automation UI untuk elemen pada titik yang ditentukan.

Sintaks

HRESULT UiaNodeFromPoint(
  [in]  double          x,
  [in]  double          y,
  [in]  UiaCacheRequest *pRequest,
  [out] SAFEARRAY       **ppRequestedData,
  [out] BSTR            *ppTreeStructure
);

Parameter

[in] x

Jenis: ganda

Koordinat horizontal titik.

[in] y

Jenis: ganda

Koordinat vertikal titik.

[in] pRequest

Jenis: UiaCacheRequest*

Alamat struktur UiaCacheRequest yang berisi permintaan cache untuk informasi dari klien.

[out] ppRequestedData

Jenis: SAFEARRAY**

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

[out] ppTreeStructure

Jenis: BSTR*

Alamat variabel yang menerima deskripsi struktur pohon. Parameter ini diteruskan tanpa diinisialisasi. Lihat Keterangan.

Nilai kembali

Jenis: HRESULT

Mengembalikan S_OK jika berhasil atau nilai kesalahan sebaliknya.

Keterangan

Elemen yang dikembalikan akan menjadi elemen terdekat dalam struktur pohon Automation UI yang cocok dengan kriteria yang ditentukan.

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