Fungsi AccessibleObjectFromWindow (oleacc.h)

Artikel
03/08/2023

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
E_INVALIDARG	Argumen tidak valid.
E_NOINTERFACE	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

AccessibleObjectFromEvent

AccessibleObjectFromPoint

IAccessible

IDispatch

Share via