Bagikan melalui


Menerapkan Pola Kontrol UI Automation MultipleView

Nota

Dokumentasi ini ditujukan untuk pengembang .NET Framework yang ingin menggunakan kelas Automation UI terkelola yang ditentukan dalam namespace System.Windows.Automation. Untuk informasi terbaru tentang Automasi UI, lihat Windows Automation API: UI Automation.

Topik ini memperkenalkan panduan dan konvensi untuk menerapkan IMultipleViewProvider, termasuk informasi tentang peristiwa dan properti. Tautan ke referensi tambahan tercantum di akhir topik.

Pola MultipleViewPattern kontrol digunakan untuk mendukung kontrol yang menyediakan, dan dapat beralih di antara, beberapa representasi dari kumpulan informasi atau kontrol anak yang sama.

Contoh kontrol yang bisa menyajikan beberapa tampilan mencakup tampilan daftar (yang bisa memperlihatkan isinya sebagai gambar mini, petak peta, ikon, atau detail), bagan Microsoft Excel (pai, garis, batang, nilai sel dengan rumus), dokumen Microsoft Word (normal, Tata letak web, tata letak cetak, tata letak baca, kerangka), kalender Microsoft Outlook (tahun, bulan, minggu, hari), dan kulit Microsoft Windows Media Player. Tampilan yang didukung ditentukan oleh pengembang kontrol dan khusus untuk setiap kontrol.

Pedoman dan Konvensi Implementasi

Saat menerapkan pola kontrol Multiple View, perhatikan panduan dan konvensi berikut:

  • IMultipleViewProvider juga harus diimplementasikan pada kontainer yang mengelola tampilan saat ini jika berbeda dari kontrol yang menyediakan tampilan saat ini. Misalnya, Windows Explorer berisi kontrol Daftar untuk isi folder saat ini sementara tampilan untuk kontrol dikelola dari aplikasi Windows Explorer.

  • Kontrol yang dapat mengurutkan kontennya tidak dianggap mendukung beberapa tampilan.

  • Kumpulan pandangan harus identik di setiap instans.

  • Nama tampilan harus cocok untuk digunakan dalam Teks ke Ucapan, Braille, dan aplikasi lain yang dapat dibaca oleh manusia.

Anggota yang Diperlukan untuk IMultipleViewProvider

Properti dan metode berikut diperlukan untuk menerapkan IMultipleViewProvider.

Anggota yang diperlukan Jenis anggota Catatan
CurrentView Harta benda Tidak ada
GetSupportedViews Metode Tidak ada
GetViewName Metode Tidak ada
SetCurrentView Metode Tidak ada

Tidak ada peristiwa yang terkait dengan pola kontrol ini.

Pengecualian

Penyedia harus memberikan pengecualian berikut.

Jenis pengecualian Keadaan
ArgumentException Entah SetCurrentView atau GetViewName dipanggil dengan parameter yang bukan anggota dari koleksi tampilan yang didukung.

Lihat juga