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