Bagikan melalui

Pola Kontrol Kisi

  • Artikel

Menjelaskan panduan dan konvensi untuk menerapkan IGridProvider, termasuk informasi tentang properti dan metode. Pola kontrol Grid digunakan untuk mendukung kontrol yang bertindak sebagai kontainer untuk kumpulan elemen anak.

Elemen ini harus menerapkan IGridItemProvider dan diatur dalam sistem koordinat logis dua dimensi yang dapat dilalui berdasarkan baris dan kolom. Untuk contoh kontrol yang mengimplementasikan pola kontrol ini, lihat Jenis Kontrol dan Pola Kontrol yang Didukung.

Topik ini berisi bagian berikut.

Panduan dan Konvensi Implementasi

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

  • Koordinat kisi berbasis nol dengan kiri atas (atau sel kanan atas tergantung pada lokal) yang memiliki koordinat (0,0).

  • Jika sel kosong, elemen Otomatisasi UI Microsoft masih harus dikembalikan untuk mendukung properti IGridItemProvider::ContainingGrid untuk sel tersebut. Hal ini dimungkinkan ketika tata letak elemen turunan dalam kisi mirip dengan array yang tidak rata (lihat contoh di bawah).

    contoh kontrol kisi dengan koordinat kosong

  • Kisi dengan satu item masih diperlukan untuk mengimplementasikan IGridProvider jika secara logis dianggap sebagai kisi. Jumlah item turunan dalam kisi tidak bersifat imaterial.

  • Baris dan kolom tersembunyi, tergantung pada implementasi penyedia, dapat dimuat di pohon Automation UI dan oleh karena itu akan tercermin dalam properti IGridProvider::RowCount dan ColumnCount . Jika baris dan kolom tersembunyi belum dimuat, baris dan kolom tersebut tidak boleh dihitung.

  • IGridProvider tidak mengaktifkan manipulasi aktif kisi; ITransformProvider harus diimplementasikan untuk mengaktifkan fungsionalitas ini.

  • Gunakan IUIAutomationStructureChangedEventHandler untuk mendengarkan perubahan struktural atau tata letak ke kisi seperti sel yang telah ditambahkan, dihapus, atau digabungkan.

  • Gunakan IUIAutomationFocusChangedEventHandler untuk melacak traversal melalui item atau sel kisi.

Anggota yang Diperlukan untuk IGridProvider

Properti dan metode berikut diperlukan untuk mengimplementasikan antarmuka IGridProvider .

Anggota yang diperlukan Jenis anggota Catatan
RowCount Properti Tidak ada
ColumnCount Properti Tidak ada
GetItem Metode Tidak ada

 

Pola kontrol ini tidak memiliki peristiwa terkait.

Jenis Kontrol dan Pola Kontrol yang Didukung

Pola Kontrol GridItem

Gambaran Umum Pola Kontrol UI Automation

Gambaran Umum Pohon UI Automation