Fungsi CreateStdAccessibleProxyA (oleacc.h)
Membuat objek yang dapat diakses yang memiliki properti dan metode dari kelas elemen antarmuka pengguna yang disediakan sistem yang ditentukan.
Sintaks
HRESULT CreateStdAccessibleProxyA(
[in] HWND hwnd,
[in] LPCSTR pClassName,
[in] LONG idObject,
[in] REFIID riid,
[out] void **ppvObject
);
Parameter
[in] hwnd
Jenis: HWND
Handel jendela elemen antarmuka pengguna yang disediakan sistem (kontrol) tempat objek yang dapat diakses dibuat.
[in] pClassName
Jenis: LPCTSTR
Penunjuk ke string yang dihentikan null dari nama kelas elemen antarmuka pengguna yang disediakan sistem tempat objek yang dapat diakses dibuat. Nama kelas jendela adalah salah satu kontrol umum (ditentukan dalam Comctl32.dll), kontrol yang telah ditentukan sebelumnya (ditentukan dalam User32.dll), atau elemen jendela.
[in] idObject
Jenis: LONG
ID Objek. Nilai ini biasanya OBJID_CLIENT, yang merupakan salah satu konstanta pengidentifikasi objek, tetapi mungkin merupakan pengidentifikasi objek lain.
[in] riid
Jenis: REFIID
Pengidentifikasi referensi antarmuka yang diminta. Nilai ini adalah salah satu dari berikut ini: IID_IAccessible, IID_IDispatch, IID_IEnumVARIANT, atau IID_IUnknown.
[out] ppvObject
Jenis: void**
Alamat variabel pointer yang menerima alamat antarmuka yang ditentukan.
Mengembalikan nilai
Jenis: STDAPI
Jika berhasil, mengembalikan S_OK.
Jika tidak berhasil, mengembalikan kode kesalahan COM standar.
Keterangan
Aplikasi server memanggil fungsi ini ketika berisi kontrol kustom yang mirip dengan kontrol yang disediakan sistem. Aplikasi server dapat memanggil CreateStdAccessibleProxy untuk mengambil alih metode dan properti IAccessible sesuai kebutuhan untuk mencocokkan kontrol kustom mereka. Atau, pengembang server dapat menggunakan Anotasi Dinamis untuk mengambil alih properti tertentu tanpa harus menggunakan teknik subkelas yang sulit yang diperlukan dengan CreateStdAccessibleProxy. Pengembang server masih harus menggunakan CreateStdAccessibleProxy untuk perubahan struktural, seperti menyembunyikan elemen anak atau membuat elemen anak tempat penampung. Pendekatan ini menghemat pekerjaan pengembang server untuk sepenuhnya mengimplementasikan semua properti dan metode IAccessible .
Fungsi ini mirip dengan CreateStdAccessibleObject, kecuali bahwa CreateStdAccessibleObject selalu menggunakan nama kelas yang terkait dengan hwnd sedangkan CreateStdAccessibleProxy memungkinkan Anda menentukan nama kelas sebagai parameter.
Gunakan CreateStdAccessibleProxy untuk membuat objek yang dapat diakses untuk elemen antarmuka pengguna yang di-superclassed. Saat elemen antarmuka pengguna di-superclassed, aplikasi membuat kontrol kustom dengan nama kelas jendela yang berbeda dari kontrol yang telah ditentukan sebelumnya yang menjadi dasarnya. Karena nama kelas yang terkait dengan parameter hwnd adalah nama kelas jendela superclass, tentukan nama kelas dasar (nama kelas sistem tempat kontrol superclassed berada) di pszClassName.
Catatan
Header oleacc.h mendefinisikan CreateStdAccessibleProxy sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.
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 di Windows NT 4.0 dengan SP6 dan yang lebih baru dan Windows 95 |
Lihat juga
Lampiran A: Referensi Elemen Antarmuka Pengguna yang Didukung