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 Automasi UI adalah membuat objek kelas CUIAutomation . Objek ini mengekspos antarmuka IUIAutomation , yang merupakan gateway ke semua objek dan antarmuka lain yang digunakan oleh aplikasi klien. Antara lain, IUIAutomation digunakan untuk tugas-tugas berikut:

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

Membuat Objek

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

  • Sertakan UIAutomation.h di header proyek Anda. UIAutomation.h membawa header lain yang menentukan API.
  • Nyatakan penunjuk 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 penunjuk 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

Ringkasan Aktivitas UI Automation

Mendapatkan Elemen Automasi Antarmuka Pengguna