Fungsi UiaReturnRawElementProvider (uiautomationcoreapi.h)
Mendapatkan antarmuka ke penyedia Automation UI untuk jendela.
Sintaks
LRESULT UiaReturnRawElementProvider(
[in] HWND hwnd,
[in] WPARAM wParam,
[in] LPARAM lParam,
[in] IRawElementProviderSimple *el
);
Parameter
[in] hwnd
Jenis: HWND
Handel jendela yang berisi elemen yang dilayani oleh penyedia.
[in] wParam
Jenis: WPARAM
Argumen wParam dari pesan WM_GETOBJECT .
[in] lParam
Jenis: LPARAM
Argumen lParam dari pesan WM_GETOBJECT .
[in] el
Jenis: IRawElementProviderSimple*
Penyedia Automasi UI.
Nilai kembali
Jenis: LRESULT
Kunci untuk proses klien untuk terhubung ke proses server melalui Automasi UI.
Fungsi ini mengembalikan nol ketika digunakan untuk memberi tahu Automasi UI bahwa aman untuk menghapus peta raised-event penyedia. Untuk informasi selengkapnya, lihat Keterangan.
Keterangan
Fungsi ini dipanggil oleh kontrol ketika menerima pesan WM_GETOBJECT , untuk menyediakan Automasi UI dengan penyedia Automation UI untuk kontrol. Kontrol harus meneruskan parameter wParam dan lParam ke fungsi UiaReturnRawElementProvider tanpa memfilternya terlebih dahulu, karena pemfilteran dapat menyebabkan masalah dengan klien Aksesibilitas Aktif Microsoft. Prosedur jendela kontrol harus mengembalikan hasil panggilan UiaReturnRawElementProvider.
Saat klien Aksesibilitas Aktif Microsoft mendengarkan peristiwa yang diangkat oleh penyedia Automation UI, UI Automation mempertahankan peta penyedia yang telah memunculkan peristiwa. Saat klien Aksesibilitas Aktif Microsoft meminta informasi lebih lanjut, Automasi UI menggunakan peta untuk merutekan permintaan ke penyedia yang sesuai. Ketika jendela yang sebelumnya dikembalikan penyedia telah dihancurkan, Anda harus memberi tahu Automasi UI dengan memanggil fungsi UiaReturnRawElementProvider sebagai berikut: UiaReturnRawElementProvider(hwnd, 0, 0, NULL)
. Panggilan ini memberi tahu Automation UI bahwa ia dapat dengan aman menghapus semua entri peta yang merujuk ke jendela yang ditentukan. Panggilan ini dapat menyimpan memori karena merilis referensi ke penyedia yang ditahan oleh peta raised-event. Fungsi mengembalikan nol ketika dipanggil dengan parameter khusus ini. Microsoft merekomendasikan untuk melakukan panggilan ini dari penangan pesan WM_DESTROY jendela yang mengembalikan penyedia Automation UI.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows XP [aplikasi desktop | Aplikasi UWP] |
Server minimum yang didukung | Windows Server 2003 [aplikasi desktop | Aplikasi UWP] |
Target Platform | Windows |
Header | uiautomationcoreapi.h |
Pustaka | Uiautomationcore.lib |
DLL | Uiautomationcore.dll |