Metode IAccessibleWindowlessSite::AcquireObjectIdRange (oleacc.h)
Memperoleh berbagai ID objek dari host kontrol dan menandainya sebagai dicadangkan oleh kontrol tanpa jendela tertentu.
Sintaks
HRESULT AcquireObjectIdRange(
[in] long rangeSize,
[in, optional] IAccessibleHandler *pRangeOwner,
[out] long *pRangeBase
);
Parameter
[in] rangeSize
Ukuran rentang ID objek yang sedang diminta.
[in, optional] pRangeOwner
Kontrol tanpa jendela yang meminta rentang.
[out] pRangeBase
ID objek pertama dalam rentang yang diperoleh.
Nilai kembali
Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.
Keterangan
Untuk menghindari penggunaan ID objek milik kontrol tanpa jendela lain, kontrol harus memperoleh rentang ID objek sebelum memanggil fungsi NotifyWinEvent . Kontrol harus memperoleh ID objek yang cukup untuk semua objek yang terkandung dapat diakses. Misalnya, kontrol pohon dengan 100 anak akan memesan setidaknya 101 ID objek, satu untuk akar, dan satu untuk setiap anak. Kontrol pohon yang diharapkan tumbuh akan mencadangkan ID objek sebanyak yang diharapkan. Jika kontrol pohon diperkirakan akan tumbuh beberapa ratus anak, itu akan memesan kisaran 1000 ID hanya untuk aman.
Ketika jendela yang berisi kontrol Microsoft ActiveX menerima pesan WM_GETOBJECT dengan nilai LPARAM (ID objek) yang berada dalam rentang yang dicadangkan, itu harus memanggil metode IAccessibleHandler::AccessibleObjectFromID untuk mendapatkan objek IAccessible untuk ID objek tersebut.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 8 [khusus aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2012 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | oleacc.h |
| Pustaka | Oleacc.lib |
| DLL | Oleacc.dll |