Metode IAccPropServer::GetPropValue (oleacc.h)
Mengambil nilai properti untuk elemen yang dapat diakses.
Sintaks
HRESULT GetPropValue(
[in] const BYTE *pIDString,
[in] DWORD dwIDStringLen,
[in] MSAAPROPID idProp,
[out] VARIANT *pvarValue,
[out] BOOL *pfHasProp
);
Parameter
[in] pIDString
Jenis: const BYTE*
Berisi string yang mengidentifikasi properti yang diminta.
[in] dwIDStringLen
Jenis: DWORD
Menentukan panjang string identitas yang ditentukan oleh parameter pIDString .
[in] idProp
Jenis: MSAAPROPID
Menentukan GUID yang menunjukkan properti yang diinginkan.
[out] pvarValue
Jenis: VARIAN*
Menentukan nilai properti yang ditimpa. Parameter ini hanya valid jika pfHasProptrue. Server harus mengatur ini ke VT_EMPTY jika pfHasProp diatur ke FALSE.
[out] pfHasProp
Jenis: BOOL*
Menunjukkan apakah server menyediakan nilai untuk properti yang diminta. Server harus mengatur ini ke TRUE jika mengembalikan properti penimpaan atau ke FALSE jika tidak mengembalikan properti (dalam hal ini juga harus mengatur pvarValue ke VT_EMPTY).
Mengembalikan nilai
Jenis: HRESULT
Kembalikan S_OK, kecuali dalam kondisi kesalahan yang luar biasa seperti memori rendah. Jika properti yang ditentukan tidak ditimpa, maka pfHasProp harus diatur ke FALSE dan pvarValue harus diatur ke VT_EMPTY oleh server.
Keterangan
Jika satu objek panggilan balik didaftarkan untuk menganotasi beberapa elemen yang dapat diakses, string identitas dapat digunakan untuk menentukan elemen mana yang dirujuk permintaan ini.
Jika elemen yang dapat diakses berbasis HWND, IAccPropServices::D ecomposeHwndIdentityString dapat digunakan untuk mengekstrak HWND/idObject/idChild dari string identitas.
Jika panggilan balik memiliki nilai yang akan dikembalikan untuk properti yang ditentukan, callback harus mengembalikannya dalam pvarValue dan mengatur pfHasProp ke TRUE. Jika tidak, itu harus mengatur pvarValue ke VT_EMPTY dan mengatur pfHasProp ke FALSE. Dalam kasus terakhir ini, penunjuk antarmuka IAccessible asli akan digunakan untuk mendapatkan nilai untuk properti ini.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows Vista atau Windows XP |
Server minimum yang didukung | Windows Server 2003 |
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 |