Metode IUIAutomationTreeWalker::NormalizeElement (uiautomationclient.h)

  • Artikel

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 yang terdekat dengan elemen yang ditentukan dalam tampilan pohon.

Mengembalikan nilai

Jenis: HRESULT

Jika metode ini berhasil, metode akan 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 diteruskan diuji untuk melihat apakah cocok dengan kondisi normalisasi. Jika demikian, elemen yang diteruskan 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 temuan. 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)