Bagikan melalui

Pola Kontrol ObjectModel

  • Artikel

Menjelaskan panduan dan konvensi untuk menerapkan IObjectModelProvider, termasuk informasi tentang metode. Pola kontrol ObjectModel digunakan untuk mengekspos penunjuk ke model objek yang mendasar dari dokumen.

Banyak aplikasi menerapkan model objek kaya yang menambah nilai di luar apa yang disediakan Microsoft UI Automation. Pola kontrol ini memungkinkan klien untuk menavigasi dari elemen Automation UI ke dalam model objek yang mendasar.

Topik ini berisi bagian berikut.

Panduan dan Konvensi Implementasi

Saat menerapkan pola kontrol ObjectModel , perhatikan panduan dan konvensi berikut:

  • Metode IObjectModelProvider::GetUnderlyingObjectModel harus mengembalikan penunjuk ke objek yang sedekat mungkin dengan elemen UI sumber. Misalnya, di browser web, penyedia Automation UI untuk satu elemen harus mengembalikan penunjuk model objek untuk elemen . Mengembalikan penunjuk model objek untuk akar dokumen akan jauh lebih berguna.
  • Klien pola kontrol ObjectModel diharapkan memiliki IID untuk antarmuka yang mereka cari, itulah sebabnya cukup untuk mengembalikan pointer IUnknown sederhana.
  • Karena Automation UI menghaluskan penunjuk ke proses klien, penyedia harus mengharapkan klien untuk mengakses model objek menggunakan praktik Model Objek Komponen (COM) standar.

Anggota yang Diperlukan untuk IObjectModelProvider

Metode berikut diperlukan untuk mengimplementasikan antarmuka IObjectModelProvider .

Anggota yang diperlukan Jenis anggota Catatan
GetUnderlyingObjectModel Metode Mengembalikan penunjuk COM ke model objek yang mendasar. Klien diharapkan untuk memanggil metode IUnknown::QueryInterface untuk mengambil penunjuk model objek tertentu.

 

Pola kontrol ini tidak memiliki peristiwa terkait.

Jenis Kontrol dan Pola Kontrol yang Didukung

Gambaran Umum Pola Kontrol UI Automation

Gambaran Umum Pohon UI Automation