Metode IUIAutomationTextRange::GetAttributeValue (uiautomationclient.h)

Mengambil nilai atribut teks yang ditentukan di seluruh rentang teks.

Sintaks

HRESULT GetAttributeValue(
  [in]          TEXTATTRIBUTEID attr,
  [out, retval] VARIANT         *value
);

Parameter

[in] attr

Jenis: TEXTATTRIBUTEID

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

[out, retval] value

Jenis: VARIAN*

Menerima nilai atribut yang ditentukan.

Nilai kembali

Jenis: HRESULT

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

Keterangan

Jenis nilai yang diambil oleh metode ini tergantung pada parameter attr . Misalnya, memanggil GetAttributeValue dengan parameter attr yang diatur ke UIA_FontNameAttributeId mengembalikan string yang mewakili nama font rentang teks, saat memanggil GetAttributeValue dengan attr diatur ke UIA_IsItalicAttributeId akan mengembalikan boolean.

Jika atribut yang ditentukan oleh attr tidak didukung, parameter nilai menerima nilai yang setara dengan properti IUIAutomation::ReservedNotSupportedValue .

Rentang teks dapat menyertakan lebih dari satu nilai untuk atribut tertentu. Misalnya, jika rentang teks menyertakan lebih dari satu font, atribut FontName akan memiliki beberapa nilai. Atribut dengan lebih dari satu nilai disebut atribut campuran. Anda dapat menentukan apakah atribut tertentu adalah atribut campuran dengan membandingkan nilai yang diambil dari GetAttributeValue dengan properti UIAutomation::ReservedMixedAttributeValue .

Metode GetAttributeValue mengambil nilai atribut terlepas dari apakah teks disembunyikan atau terlihat. Gunakan UIA_ IsHiddenAttributeId untuk memeriksa visibilitas teks.

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)

Lihat juga

IUIAutomationTextRange

Dukungan Automation UI untuk Konten Tekstual