Metode IUIAutomationElement::GetCurrentPropertyValueEx (uiautomationclient.h)
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) |
Lihat juga
Konseptual
Referensi