Antarmuka IUIAutomation (uiautomationclient.h)
Mengekspos metode yang memungkinkan aplikasi klien Microsoft UI Automation untuk menemukan, mengakses, dan memfilter elemen Automation UI. Automasi UI mengekspos setiap elemen Automation UI sebagai objek yang diwakili oleh antarmuka IUIAutomation . Anggota antarmuka ini tidak spesifik untuk elemen tertentu.
Warisan
Antarmuka IUIAutomation mewarisi dari antarmuka IUnknown . IUIAutomation juga memiliki jenis anggota ini:
Metode
Antarmuka IUIAutomation memiliki metode ini.
| IUIAutomation::AddAutomationEventHandler Mendaftarkan metode yang menangani peristiwa Microsoft UI Automation. Catatan Sebelum menerapkan penanganan aktivitas, Anda harus terbiasa dengan masalah utas yang dijelaskan dalam Memahami Masalah Utas. |
| IUIAutomation::AddFocusChangedEventHandler Mendaftarkan metode yang menangani peristiwa yang diubah fokus. Catatan Sebelum menerapkan penanganan aktivitas, Anda harus terbiasa dengan masalah utas yang dijelaskan dalam Memahami Masalah Utas. |
| IUIAutomation::AddPropertyChangedEventHandler Mendaftarkan metode yang menangani dan array peristiwa yang diubah properti. |
| IUIAutomation::AddPropertyChangedEventHandlerNativeArray Mendaftarkan metode yang menangani array asli peristiwa yang diubah properti. |
| IUIAutomation::AddStructureChangedEventHandler Mendaftarkan metode yang menangani peristiwa yang diubah struktur. Catatan Sebelum menerapkan penanganan aktivitas, Anda harus terbiasa dengan masalah utas yang dijelaskan dalam Memahami Masalah Utas. |
| IUIAutomation::CheckNotSupported Memeriksa VARIAN yang disediakan untuk melihat apakah varian tersebut berisi pengidentifikasi Tidak Didukung. |
| IUIAutomation::CompareElements Membandingkan dua elemen Automation UI untuk menentukan apakah mereka mewakili elemen UI yang mendasar yang sama. |
| IUIAutomation::CompareRuntimeIds Membandingkan dua array bilangan bulat yang berisi pengidentifikasi run-time (ID) untuk menentukan apakah kontennya sama dan mereka termasuk dalam elemen UI yang sama. |
| IUIAutomation::CreateAndCondition Membuat kondisi yang memilih elemen yang cocok dengan kedua kondisi tersebut. |
| IUIAutomation::CreateAndConditionFromArray Membuat kondisi yang memilih elemen berdasarkan beberapa kondisi, yang semuanya harus benar. |
| IUIAutomation::CreateAndConditionFromNativeArray Membuat kondisi yang memilih elemen dari array asli, berdasarkan beberapa kondisi yang semuanya harus benar. |
| IUIAutomation::CreateCacheRequest Membuat permintaan cache. |
| IUIAutomation::CreateFalseCondition Membuat kondisi yang selalu salah. |
| IUIAutomation::CreateNotCondition Membuat kondisi yang negatif dari kondisi yang ditentukan. |
| IUIAutomation::CreateOrCondition Membuat kombinasi dua kondisi di mana kecocokan ada jika salah satu kondisinya benar. |
| IUIAutomation::CreateOrConditionFromArray Membuat kombinasi dua kondisi atau lebih di mana kecocokan ada jika salah satu kondisinya benar. |
| IUIAutomation::CreateOrConditionFromNativeArray Membuat kombinasi dua kondisi atau lebih di mana kecocokan ada jika salah satu kondisinya benar. |
| IUIAutomation::CreatePropertyCondition Membuat kondisi yang memilih elemen yang memiliki properti dengan nilai yang ditentukan. |
| IUIAutomation::CreatePropertyConditionEx Membuat kondisi yang memilih elemen yang memiliki properti dengan nilai yang ditentukan, menggunakan bendera opsional. |
| IUIAutomation::CreateProxyFactoryEntry Membuat instans baru objek pabrik proksi. |
| IUIAutomation::CreateTreeWalker Mengambil objek tree walker yang dapat digunakan untuk melintasi pohon Microsoft UI Automation. |
| IUIAutomation::CreateTrueCondition Mengambil kondisi yang telah ditentukan sebelumnya yang memilih semua elemen. |
| IUIAutomation::ElementFromHandle Mengambil elemen Automation UI untuk jendela yang ditentukan. |
| IUIAutomation::ElementFromHandleBuildCache Mengambil elemen Automation UI untuk jendela yang ditentukan, mengambil properti dan pola kontrol yang diminta sebelumnya, dan menyimpan item yang telah diambil sebelumnya dalam cache. |
| IUIAutomation::ElementFromIAccessible Mengambil elemen Automation UI untuk objek yang dapat diakses yang ditentukan dari server Aksesibilitas Aktif Microsoft. |
| IUIAutomation::ElementFromIAccessibleBuildCache Mengambil elemen Automation UI untuk objek yang dapat diakses yang ditentukan dari server Aksesibilitas Aktif Microsoft, mengambil properti dan pola kontrol yang diminta sebelumnya, dan menyimpan item yang telah diambil sebelumnya dalam cache. |
| IUIAutomation::ElementFromPoint Mengambil elemen Automation UI pada titik yang ditentukan pada desktop. |
| IUIAutomation::ElementFromPointBuildCache Mengambil elemen Automation UI pada titik yang ditentukan di desktop, mengambil properti dan pola kontrol yang diminta sebelumnya, dan menyimpan item yang telah diambil sebelumnya dalam cache. |
| IUIAutomation::get_ContentViewCondition Mengambil antarmuka IUIAutomationCondition yang telah ditentukan sebelumnya yang memilih elemen konten. |
| IUIAutomation::get_ContentViewWalker Mengambil antarmuka IUIAutomationTreeWalker yang digunakan untuk menemukan elemen konten. |
| IUIAutomation::get_ControlViewCondition Mengambil antarmuka IUIAutomationCondition yang telah ditentukan sebelumnya yang memilih elemen kontrol. |
| IUIAutomation::get_ControlViewWalker Mengambil antarmuka IUIAutomationTreeWalker yang digunakan untuk menemukan elemen kontrol. |
| IUIAutomation::get_ProxyFactoryMapping Mengambil objek yang mewakili pemetaan nama kelas Jendela dan data terkait ke pabrik proksi individual. |
| IUIAutomation::get_RawViewCondition Mengambil antarmuka IUIAutomationCondition yang telah ditentukan sebelumnya yang memilih semua elemen UI dalam tampilan yang tidak difilter. |
| IUIAutomation::get_RawViewWalker Mengambil objek pejalan pohon yang digunakan untuk melintasi tampilan pohon Microsoft UI Automation yang tidak difilter. |
| IUIAutomation::get_ReservedMixedAttributeValue Mengambil objek token statis yang mewakili atribut teks yang merupakan atribut campuran. |
| IUIAutomation::get_ReservedNotSupportedValue Mengambil objek token statis yang mewakili atribut properti atau teks yang tidak didukung. |
| IUIAutomation::GetFocusedElement Mengambil elemen Automation UI yang memiliki fokus input. |
| IUIAutomation::GetFocusedElementBuildCache Mengambil elemen Automation UI yang memiliki fokus input, mengambil properti dan pola kontrol yang diminta sebelumnya, dan menyimpan item yang telah diambil sebelumnya dalam cache. |
| IUIAutomation::GetPatternProgrammaticName Mengambil nama terprogram terdaftar dari pola kontrol. |
| IUIAutomation::GetPropertyProgrammaticName Mengambil nama terprogram properti yang terdaftar. |
| IUIAutomation::GetRootElement Mengambil elemen Automation UI yang mewakili desktop. |
| IUIAutomation::GetRootElementBuildCache Mengambil elemen Automation UI yang mewakili desktop, mengambil properti dan pola kontrol yang diminta sebelumnya, dan menyimpan item yang telah diambil sebelumnya dalam cache. |
| IUIAutomation::IntNativeArrayToSafeArray Mengonversi array bilangan bulat menjadi SAFEARRAY. |
| IUIAutomation::IntSafeArrayToNativeArray Mengonversi SAFEARRAY bilangan bulat menjadi array. |
| IUIAutomation::P ollForPotentialSupportedPatterns Mengambil pola kontrol yang mungkin didukung pada elemen Automation UI. |
| IUIAutomation::P ollForPotentialSupportedProperties Mengambil properti yang mungkin didukung pada elemen Automation UI. |
| IUIAutomation::RectToVariant Membuat VARIAN yang berisi koordinat persegi panjang. |
| IUIAutomation::RemoveAllEventHandlers Menghapus semua penanganan aktivitas Microsoft UI Automation yang terdaftar. |
| IUIAutomation::RemoveAutomationEventHandler Menghapus penanganan aktivitas Automation UI yang ditentukan. |
| IUIAutomation::RemoveFocusChangedEventHandler Menghapus penanganan aktivitas yang diubah fokus. |
| IUIAutomation::RemovePropertyChangedEventHandler Menghapus penanganan aktivitas yang diubah properti. |
| IUIAutomation::RemoveStructureChangedEventHandler Menghapus penanganan aktivitas yang diubah struktur. |
| IUIAutomation::SafeArrayToRectNativeArray Mengonversi SAFEARRAY yang berisi koordinat persegi panjang ke array jenis RECT. |
| IUIAutomation::VariantToRect Mengonversi VARIAN yang berisi koordinat persegi panjang menjadi RECT. |
Keterangan
Setiap aplikasi klien Automation UI harus mendapatkan antarmuka ini ke objek CUIAutomation untuk mendapatkan akses ke fungsionalitas Automasi UI.
Contoh fungsi berikut membuat objek CUIAutomation dan mendapatkan antarmuka IUIAutomation .
IUIAutomation *g_pAutomation;
BOOL InitializeUIAutomation()
{
CoInitialize(NULL);
HRESULT hr = CoCreateInstance(__uuidof(CUIAutomation), NULL, CLSCTX_INPROC_SERVER,
__uuidof(IUIAutomation), (void**)&g_pAutomation);
return (SUCCEEDED(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) |