Metode IUIAutomationElement::GetCurrentPropertyValueEx (uiautomationclient.h)

Artikel
03/09/2024

Mengambil nilai properti untuk elemen Automation UI ini, secara opsional mengabaikan nilai default apa pun.

Sintaks

HRESULT GetCurrentPropertyValueEx(
  [in]          PROPERTYID propertyId,
  [in]          BOOL       ignoreDefaultValue,
  [out, retval] VARIANT    *retVal
);

Parameter

[in] propertyId

Jenis: PROPERTYID

Pengidentifikasi properti. Untuk daftar ID properti, lihat Pengidentifikasi Properti.

[in] ignoreDefaultValue

Jenis: BOOL

Nilai yang menentukan apakah nilai default harus diabaikan jika properti yang ditentukan tidak didukung: TRUE jika nilai default tidak akan dikembalikan, atau FALSE jika akan dikembalikan.

[out, retval] retVal

Jenis: VARIAN*

Menerima nilai properti.

Nilai kembali

Jenis: HRESULT

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

Keterangan

Meneruskan FALSE dalam parameter ignoreDefaultValue setara dengan memanggil IUIAutomationElement::GetCurrentPropertyValue.

Jika penyedia Microsoft UI Automation untuk elemen itu sendiri mendukung properti , nilai properti dikembalikan. Jika tidak, jika ignoreDefaultValue adalah FALSE, nilai default yang ditentukan oleh Automasi UI dikembalikan.

Metode ini mengembalikan kode kegagalan jika properti yang diminta sebelumnya tidak di-cache.

Properti Automasi UI dari jenis ganda mendukung nilai Bukan Angka (NaN). Saat mengambil properti dari jenis ganda , klien dapat menggunakan fungsi _isnan untuk menentukan apakah properti adalah nilai NaN.

Persyaratan

Persyaratan	Nilai
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)