Bagikan melalui

Membuat Objek CUIAutomation

  • Artikel

Bagian ini menjelaskan cara mulai menulis aplikasi klien Microsoft UI Automation dengan membuat instans objek yang mengimplementasikan IUIAutomation.

Topik ini berisi bagian berikut.

Objek CUIAutomation

Langkah pertama dalam menggunakan UI Automation adalah membuat objek dari kelas CUIAutomation. Objek ini mengekspos antarmukaIUIAutomation, yang merupakan gateway ke semua objek dan antarmuka lain yang digunakan oleh aplikasi klien. Antara lain, IUIAutomation digunakan untuk tugas-tugas berikut:

  • Berlangganan acara.
  • Menciptakan kondisi. Kondisi adalah objek yang digunakan untuk mempersempit cakupan pencarian untuk elemen Automation UI.
  • Mendapatkan elemen Automation UI langsung dari desktop (elemen root), atau dari koordinat layar atau handel jendela.
  • Membuat objek pemandu pohon yang dapat digunakan untuk menavigasi hierarki elemen Automation UI.
  • Mengonversi jenis data.

Membuat Objek

Untuk mulai menggunakan Automasi UI di aplikasi Anda, lakukan langkah-langkah berikut:

  • Sertakan UIAutomation.h di header proyek Anda. UIAutomation.h membawa header lain yang menentukan API.
  • Deklarasikan pointer ke IUIAutomation.
  • Menginisialisasi Model Objek Komponen (COM).
  • Buat instans CUIAutomation dan ambil antarmuka IUIAutomation di pointer Anda.

Contoh fungsi berikut menginisialisasi COM, lalu membuat objek CUIAutomation, mengambil antarmuka IUIAutomation di pointer ppAutomation.

#include <uiautomation.h>

// CoInitialize must be called before calling this function, and the  
// caller must release the returned pointer when finished with it.
// 
HRESULT InitializeUIAutomation(IUIAutomation **ppAutomation)
{
    return CoCreateInstance(CLSID_CUIAutomation, NULL,
        CLSCTX_INPROC_SERVER, IID_IUIAutomation, 
        reinterpret_cast<void**>(ppAutomation));
}

Konseptual

Gambaran Umum Peristiwa Automasi UI

Mendapatkan Elemen Otomasi UI