IUIAutomation::AddFocusChangedEventHandler method (uiautomationclient.h)
Mendaftarkan metode yang menangani peristiwa yang diubah fokus.
Sintaks
HRESULT AddFocusChangedEventHandler(
[in] IUIAutomationCacheRequest *cacheRequest,
[in] IUIAutomationFocusChangedEventHandler *handler
);
Parameter
[in] cacheRequest
Jenis: IUIAutomationCacheRequest*
Penunjuk ke permintaan cache, atau NULL jika tidak ada penembolokan yang diinginkan.
[in] handler
Jenis: IUIAutomationFocusChangedEventHandler*
Penunjuk ke objek yang menangani peristiwa.
Nilai kembali
Jenis: HRESULT
Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.
Keterangan
Peristiwa yang diubah fokus adalah seluruh sistem; Anda tidak dapat mengatur cakupan yang lebih sempit.
Klien Automation UI tidak boleh menggunakan beberapa utas untuk menambahkan atau menghapus penanganan aktivitas. Perilaku tak terduga dapat mengakibatkan satu penanganan aktivitas ditambahkan atau dihapus saat yang lain sedang ditambahkan atau dihapus dalam proses klien yang sama.
Contoh
Contoh fungsi berikut membuat objek yang mengimplementasikan IUIAutomationFocusChangedEventHandler dan berlangganan acara dengan menambahkan handler.
HRESULT AddFocusHandler(IUIAutomation* pAutomation)
{
// CFocusHandler is a class that implements IUIAutomationFocusChangedEventHandler.
CFocusHandler* pFocusHandler = new CFocusHandler();
if (!pFocusHandler)
{
return E_OUTOFMEMORY;
}
IUIAutomationFocusChangedEventHandler* pHandler;
pFocusHandler->QueryInterface(IID_IUIAutomationFocusChangedEventHandler, (void**)&pHandler);
HRESULT hr = pAutomation->AddFocusChangedEventHandler(NULL, pHandler);
pFocusHandler->Release();
return hr;
}
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 7, Windows Vista dengan SP2 dan Pembaruan Platform untuk Windows Vista, Windows XP dengan SP3 dan Pembaruan Platform untuk Windows Vista [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2008 R2, Windows Server 2008 dengan SP2 dan Pembaruan Platform untuk Windows Server 2008, Windows Server 2003 dengan SP2 dan Pembaruan Platform untuk Windows Server 2008 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | uiautomationclient.h (termasuk UIAutomation.h) |
Lihat juga
Properti Automasi antarmuka pengguna penembolokan dan Pola Kontrol
Konseptual
IUIAutomationFocusChangedEventHandler
Referensi
RemoveFocusChangedEventHandler