Dukungan UI Automation untuk Jenis Kontrol Tabel
Catatan
Dokumentasi ini ditujukan untuk pengembang .NET Framework yang ingin menggunakan kelas UI Automation terkelola yang ditentukan pada namespace System.Windows.Automation. Untuk informasi terbaru tentang UI Automation, lihat API Automasi Windows: Automasi Antarmuka Pengguna.
Topik ini memberikan informasi tentang dukungan UI Automation untuk tipe kontrol Tabel. Dalam UI Automation, jenis kontrol adalah kumpulan kondisi yang harus dipenuhi kontrol untuk menggunakan properti ControlTypeProperty. Kondisi ini mencakup pedoman khusus untuk struktur pohon UI Automation, nilai properti dan pola kontrol UI Automation.
Kontrol tabel memuat baris dan kolom teks, dan secara opsional, header baris dan header kolom.
Bagian berikut menentukan struktur pohon UI Automation yang diperlukan, properti, pola kontrol, dan peristiwa untuk jenis kontrol Tabel. Persyaratan UI Automation berlaku untuk semua kontrol tab, baik Windows Presentation Foundation (WPF), Win32, maupun Formulir Windows.
Struktur Pohon UI Automation yang Diperlukan
Tabel berikut menggambarkan tampilan kontrol dan tampilan konten dari pohon UI Automation yang berkaitan dengan kontrol tabel dan menjelaskan yang dapat dimuat dalam setiap tampilan. Untuk informasi selengkapnya tentang pohon UI Automation, lihat Gambaran Umum Pohon UI Automation.
| Tampilan Kontrol | Tampilan Konten |
|---|---|
| Tabel - Header (0 atau 1) - Teks (0 atau 1) - Berbagai kontrol (0 atau lebih) |
Tabel - Teks (0 atau lebih) - Berbagai kontrol (0 atau lebih) |
Jika kontrol tabel memiliki header baris atau kolom, kontrol tabel harus diekspos di Tampilan Kontrol pohon UI Automation. Tampilan Konten tidak perlu mengekspos informasi ini karena dapat diakses menggunakan TablePattern.
Properti Azure Automation Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan properti UI Automation yang nilainya atau definisinya sangat relevan dengan kontrol Tabel. Untuk mendapatkan informasi selengkapnya tentang properti UI Automation, lihat Properti UI Automation untuk Klien.
| Properti Automasi UI | Nilai | Catatan |
|---|---|---|
| AutomationIdProperty | Lihat catatan. | Nilai properti ini harus unik di semua kontrol dalam aplikasi. |
| BoundingRectangleProperty | Lihat catatan. | Persegi terluar yang berisi seluruh kontrol. |
| ClickablePointProperty | Lihat catatan. | Didukung jika ada persegi panjang pembatas. Jika tidak setiap titik dalam kotak pembatas dapat diklik, dan Anda melakukan pengujian hit khusus, maka ambil alih dan berikan titik yang dapat diklik. |
| IsKeyboardFocusableProperty | Lihat catatan. | Jika kontrol dapat menerima fokus keyboard, maka kontrol harus mendukung properti ini. |
| NameProperty | Lihat catatan. | Kontrol tabel biasanya mendapatkan namanya dari label teks statik. Jika tidak ada label teks statik, Anda harus menetapkan properti Nama yang harus selalu tersedia untuk menjelaskan tujuan tabel. |
| LabeledByProperty | Lihat catatan. | Jika ada label teks statik, properti ini harus mengekspos referensi ke elemen automasi kontrol. |
| ControlTypeProperty | Tabel | Nilai ini sama untuk semua kerangka kerja UI. |
| LocalizedControlTypeProperty | “tabel” | String yang dilokalkan sesuai dengan jenis kontrol Tabel. |
| HelpTextProperty | Lihat catatan. | Rincian selengkapnya tentang tujuan tabel harus diekspos melalui properti ini jika tidak cukup dijelaskan dengan mengakses NameProperty. |
| IsContentElementProperty | Benar | Kontrol tabel harus selalu berupa konten. |
| IsControlElementProperty | Benar | Kontrol tabel harus selalu berupa konten. |
Pola Kontrol Automasi Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan pola kontrol UI Automation yang diperlukan untuk didukung oleh kontrol Tabel. Untuk informasi selengkapnya tentang pola kontrol, lihat Gambaran Umum Pola Kontrol Automasi Antarmuka Pengguna.
| Pola Kontrol | Dukungan | Catatan |
|---|---|---|
| IGridProvider | Ya | Kontrol tabel selalu mendukung pola kontrol ini karena item yang dimilikinya memiliki data yang disajikan dalam kisi. |
| IGridItemProvider | Ya (diperlukan dengan objek turunan) | Objek dalam tabel harus mendukung pola kontrol GridItem dan TableItem. Tabel itu sendiri tidak perlu mendukung pola kontrol GridItem atau TableItem kecuali jika tabel adalah bagian dari tabel lain. |
| ITableProvider | Ya | Kontrol tabel selalu memiliki kemampuan memiliki header yang terkait dengan konten. |
| ITableItemProvider | Ya (diperlukan dengan objek turunan) | Objek dalam tabel harus mendukung pola kontrol GridItem dan TableItem. Tabel itu sendiri tidak perlu mendukung pola kontrol GridItem atau TableItem kecuali jika tabel adalah bagian dari tabel lain. |
Peristiwa UI Automation yang Diperlukan
Tabel berikut mencantumkan peristiwa UI Automation yang diperlukan untuk didukung oleh semua kontrol tabel. Untuk informasi selengkapnya tentang acara, baca Gambaran Umum Peristiwa UI Automation.
| Peristiwa UI Automation | Dukungan | Catatan |
|---|---|---|
| BoundingRectangleProperty peristiwa perubahan properti. | Wajib | Tidak |
| IsOffscreenProperty peristiwa perubahan properti. | Wajib | Tidak |
| IsEnabledProperty peristiwa perubahan properti. | Wajib | Tidak |
| AutomationFocusChangedEvent | Wajib | Tidak |
| StructureChangedEvent | Wajib | Tidak |