Metode IAccPropServices::ClearHwndProps (oleacc.h)
Metode ini membungkus SetPropValue, SetPropServer, dan ClearProps, dan menyediakan titik masuk yang nyaman untuk penelepon yang menganotasi elemen yang dapat diakses berbasis HWND.
Sintaks
HRESULT ClearHwndProps(
[in] HWND hwnd,
[in] DWORD idObject,
[in] DWORD idChild,
[in] const MSAAPROPID *paProps,
[in] int cProps
);
Parameter
[in] hwnd
Jenis: HWND
Mengidentifikasi elemen yang dapat diakses yang akan diannotasi. Ini menggantikan string identitas.
[in] idObject
Jenis: DWORD
Mengidentifikasi elemen yang dapat diakses yang akan diannotasi. Ini menggantikan string identitas.
[in] idChild
Jenis: DWORD
Mengidentifikasi elemen yang dapat diakses yang akan diannotasi. Ini menggantikan string identitas.
[in] paProps
Jenis: const MSAAPROPID*
Menentukan array properti yang akan direset. Properti ini akan kembali ke perilaku default yang ditampilkan sebelum diannotasi.
[in] cProps
Jenis: int
Menentukan jumlah properti dalam array paProps .
Mengembalikan nilai
Jenis: HRESULT
Jika berhasil, mengembalikan S_OK, bahkan jika properti yang ditentukan tidak pernah diannotasikan pada objek yang dapat diakses; menghapus properti yang sudah dibersihkan dianggap berhasil.
Mengembalikan E_INVALIDARG jika salah satu properti dalam array paProps tidak didukung.
Dapat mengembalikan kode kesalahan lain dalam kondisi kesalahan yang luar biasa seperti memori rendah.
Untuk deskripsi nilai yang dikembalikan, lihat metode SetPropValue, SetPropServer, atau ClearProps yang sesuai.
Keterangan
Dengan menggunakan metode ini, pemanggil tidak harus mendapatkan string identitas; ini dapat menentukan parameter hwnd, idObject, dan idChild secara langsung.
Selain itu, SetHwndPropStr mengambil untai (karakter) Unicode reguler sebagai parameter; penelepon tidak perlu mengalokasikan BSTR secara khusus.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows XP [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | oleacc.h (termasuk OleAcc.h Include Initguid.h first.) |
DLL | Oleacc.dll |
Redistribusi | Aksesibilitas Aktif 2.0 RDK pada Windows NT 4.0 dengan SP6 dan yang lebih baru dan Windows 98 |