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 menambahkan 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.

Pedoman dan Konvensi Implementasi

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

  • Metode IObjectModelProvider::GetUnderlyingObjectModel harus mengembalikan pointer 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 tersebut. 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 yang sederhana.
  • Karena Automation UI mendekor 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 menerapkan antarmukaIObjectModelProvider.

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

 

Pola kontrol ini tidak memiliki peristiwa terkait.

Jenis Kontrol dan Pola Kontrol yang Didukung

Gambaran Umum Pola Kontrol Automasi UI

Gambaran Umum Pohon Automasi UI