Fungsi AccessibleObjectFromWindow (oleacc.h)
Mengambil alamat antarmuka yang ditentukan untuk objek yang terkait dengan jendela yang ditentukan.
Sintaks
HRESULT AccessibleObjectFromWindow(
[in] HWND hwnd,
[in] DWORD dwId,
[in] REFIID riid,
[out] void **ppvObject
);
Parameter
[in] hwnd
Jenis: HWND
Menentukan handel jendela yang objeknya akan diambil. Untuk mengambil penunjuk antarmuka ke kursor atau objek caret, tentukan NULL dan gunakan ID objek yang sesuai di dwObjectID.
[in] dwId
Jenis: DWORD
Menentukan ID objek. Nilai ini adalah salah satu konstanta pengidentifikasi objek standar atau ID objek kustom seperti OBJID_NATIVEOM, yang merupakan ID objek untuk model objek asli Office. Untuk informasi selengkapnya tentang OBJID_NATIVEOM, lihat bagian Keterangan dalam topik ini.
[in] riid
Jenis: REFIID
Menentukan pengidentifikasi referensi antarmuka yang diminta. Nilai ini IID_IAccessible atau IID_IDispatch, tetapi juga dapat IID_IUnknown, atau IID antarmuka apa pun yang diharapkan untuk didukung objek.
[out] ppvObject
Jenis: batal**
Alamat variabel pointer yang menerima alamat antarmuka yang ditentukan.
Mengembalikan nilai
Jenis: STDAPI
Jika berhasil, mengembalikan S_OK.
Jika tidak berhasil, mengembalikan salah satu dari kode kesalahan COM standar berikut atau lainnya.
Menampilkan kode | Deskripsi |
---|---|
|
Argumen tidak valid. |
|
Antarmuka yang diminta tidak didukung. |
Keterangan
Klien memanggil fungsi ini untuk mengambil alamat IAccessible, IDispatch, IEnumVARIANT, IUnknown objek, atau penunjuk antarmuka lain yang didukung.
Seperti metode dan fungsi IAccessible lainnya, klien mungkin menerima kesalahan untuk penunjuk antarmuka IAccessible karena tindakan pengguna. Untuk informasi selengkapnya, lihat Menerima Kesalahan untuk Penunjuk Antarmuka IAccessible.
Klien menggunakan fungsi ini untuk mendapatkan akses ke model objek asli Microsoft Office 2000. Model objek asli memberi klien informasi aksesibilitas tentang dokumen aplikasi Office atau area klien yang tidak diekspos oleh Aksesibilitas Aktif Microsoft.
Untuk mendapatkan penunjuk antarmuka IDispatch ke kelas yang didukung oleh model objek asli, tentukan OBJID_NATIVEOM dalam dwObjectID. Saat menggunakan pengidentifikasi objek ini, parameter hwnd harus cocok dengan jenis kelas jendela berikut.
Aplikasi Office | Kelas jendela | Penunjuk IDispatch ke |
---|---|---|
Word | _WwG | Jendela |
Excel | EXCEL7 | Jendela |
PowerPoint | paneClassDC | DocumentWindow |
Bilah Perintah | MsoCommandBar | Bilah Perintah |
Perhatikan bahwa kelas jendela di atas sesuai dengan jendela dokumen atau jendela panel paling dalam. Untuk informasi selengkapnya tentang model objek Office, lihat Panduan Programmer Microsoft Office 2000/Visual Basic.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | oleacc.h |
Pustaka | Oleacc.lib |
DLL | Oleacc.dll |
Redistribusi | Aksesibilitas Aktif 1.3 RDK pada Windows NT 4.0 dengan SP6 dan yang lebih baru dan Windows 95 |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk