Metode IAccPropServices::SetPropValue (oleacc.h)
Gunakan SetPropValue untuk mengidentifikasi elemen yang dapat diakses untuk diannotasi, tentukan properti yang akan diannotasi, dan berikan nilai baru untuk properti tersebut.
Jika pengembang server mengetahui HWND dari elemen yang dapat diakses yang ingin mereka anotasi, mereka dapat menggunakan salah satu metode berikut:
- IAccPropServices::SetHwndPropStr,
- IAccPropServices::SetHwndProp, atau
- IAccPropServices::SetHwndPropServer
Sintaks
HRESULT SetPropValue(
[in] const BYTE *pIDString,
[in] DWORD dwIDStringLen,
[in] MSAAPROPID idProp,
[in] VARIANT var
);
Parameter
[in] pIDString
Jenis: const BYTE*
Mengidentifikasi elemen yang dapat diakses yang akan diannotasi.
[in] dwIDStringLen
Jenis: DWORD
Menentukan panjang string yang diidentifikasi oleh parameter pIDString .
[in] idProp
Jenis: MSAAPROPID
Menentukan properti elemen yang dapat diakses untuk diannotasi.
[in] var
Jenis: VARIAN
Menentukan nilai baru untuk properti .
Mengembalikan nilai
Jenis: HRESULT
Jika berhasil, mengembalikan S_OK.
Mengembalikan E_INVALIDARG jika idProp bukan properti yang didukung, jika var bukan jenis yang didukung untuk properti tersebut, atau jika string identitas tidak valid.
Dapat mengembalikan kode kesalahan lain dalam kondisi kesalahan yang luar biasa seperti memori rendah.
Keterangan
Lihat bagian dukungan untuk daftar properti yang didukung dan jenis yang diharapkan. Perhatikan bahwa saat ini beberapa properti hanya didukung ketika panggilan balik digunakan dan tidak dapat ditentukan secara langsung menggunakan metode ini.
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 (sertakan OleAcc.h Include Initguid.h first.) |
DLL | Oleacc.dll |
Redistribusi | Aksesibilitas Aktif 2.0 RDK di Windows NT 4.0 dengan SP6 dan yang lebih baru dan Windows 98 |