ITextRangeProvider::Metode FindAttribute (uiautomationcore.h)

Artikel
03/03/2024

Mengembalikan subset rentang teks yang memiliki nilai atribut teks yang ditentukan.

Sintaks

HRESULT FindAttribute(
  [in]          TEXTATTRIBUTEID    attributeId,
  [in]          VARIANT            val,
  [in]          BOOL               backward,
  [out, retval] ITextRangeProvider **pRetVal
);

Parameter

[in] attributeId

Jenis: TEXTATTRIBUTEID

Pengidentifikasi atribut teks. Untuk daftar ID atribut teks, lihat Pengidentifikasi Atribut Teks.

[in] val

Jenis: VARIAN

Nilai atribut yang akan dicari. Nilai ini harus cocok dengan jenis yang ditentukan untuk atribut .

[in] backward

Jenis: BOOL

TRUE jika rentang teks terakhir yang muncul harus dikembalikan alih-alih yang pertama; jika tidak FALSE.

[out, retval] pRetVal

Jenis: ITextRangeProvider**

Menerima penunjuk ke rentang teks yang memiliki atribut dan nilai atribut yang cocok; jika tidak , NULL.

Nilai kembali

Jenis: HRESULT

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

Keterangan

Metode FindAttribute mengambil teks yang cocok terlepas dari apakah teks disembunyikan atau terlihat. Klien dapat menggunakan UIA_IsHiddenAttributeId untuk memeriksa visibilitas teks.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2003 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	uiautomationcore.h (termasuk UIAutomation.h)