Bagikan melalui


Metode ITextRangeProvider::GetAttributeValue (uiautomationcore.h)

Mengambil nilai atribut teks yang ditentukan di seluruh rentang teks.

Sintaks

HRESULT GetAttributeValue(
  [in]          TEXTATTRIBUTEID attributeId,
  [out, retval] VARIANT         *pRetVal
);

Parameter

[in] attributeId

Jenis: TEXTATTRIBUTEID

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

[out, retval] pRetVal

Jenis: VARIAN*

Menerima salah satu hal berikut ini.

  • Alamat objek yang mewakili nilai atribut yang ditentukan. Jenis data nilai bervariasi tergantung pada atribut yang ditentukan. Misalnya, jika attributeIdUIA_FontNameAttributeId, GetAttributeValue mengembalikan string yang mewakili nama font rentang teks, tetapi jika attributeIdUIA_IsItalicAttributeId, GetAttributeValue mengembalikan boolean.
  • Alamat nilai yang diambil oleh fungsi UiaGetReservedMixedAttributeValue , jika nilai atribut yang ditentukan bervariasi di atas rentang teks.
  • Alamat nilai yang diambil oleh fungsi UiaGetReservedNotSupportedValue , jika atribut yang ditentukan tidak didukung oleh penyedia atau kontrol.
Parameter ini diteruskan tanpa diinisialisasi.

Mengembalikan nilai

Jenis: HRESULT

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

Keterangan

Metode GetAttributeValue harus mengambil nilai atribut terlepas dari apakah teks tersembunyi atau terlihat.

Persyaratan

   
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)

Lihat juga

Konseptual

ITextProvider

ITextRangeProvider

Referensi

Gambaran Umum Penyedia UI Automation