Metode IUIAutomationTreeWalker::NormalizeElement (uiautomationclient.h)

Mengambil elemen leluhur yang terdekat dengan elemen Microsoft UI Automation yang ditentukan dalam tampilan pohon.

Sintaks

HRESULT NormalizeElement(
  [in]          IUIAutomationElement *element,
  [out, retval] IUIAutomationElement **normalized
);

Parameter

[in] element

Jenis: IUIAutomationElement*

Penunjuk ke elemen untuk memulai normalisasi.

[out, retval] normalized

Jenis: IUIAutomationElement**

Menerima penunjuk ke elemen leluhur terdekat dengan elemen yang ditentukan dalam tampilan pohon.

Mengembalikan nilai

Jenis: HRESULT

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

Keterangan

Elemen dinormalisasi dengan menavigasi rantai leluhur di pohon hingga elemen yang memenuhi kondisi tampilan (ditentukan oleh panggilan sebelumnya ke IUIAutomationTreeWalker::Condition) tercapai. Tetapi pertama-tama, elemen yang dilewatkan diuji untuk melihat apakah cocok dengan kondisi normalisasi. Jika demikian, elemen yang dilewatkan dikembalikan, meskipun bukan leluhur.

Metode mengembalikan UIA_E_ELEMENTNOTAVAILABLE jika tidak ada elemen yang cocok yang ditemukan.

Metode ini berguna untuk aplikasi yang mendapatkan referensi ke elemen Automation UI dengan pengujian klik. Aplikasi mungkin hanya ingin bekerja dengan jenis elemen tertentu, dan dapat menggunakan IUIAutomationTreeWalker::Normalize untuk memastikan bahwa tidak peduli elemen apa yang awalnya diambil (misalnya, ketika bilah gulir mendapatkan fokus input), hanya elemen yang menarik (seperti elemen konten) yang pada akhirnya diambil.

Persyaratan

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 [hanya aplikasi desktop]
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 [hanya aplikasi desktop]
Target Platform	Windows
Header	uiautomationclient.h (termasuk UIAutomation.h)