Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
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 menyediakan informasi tentang dukungan Automation UI untuk jenis kontrol Tabel. Di Automasi UI, jenis kontrol adalah serangkaian kondisi yang harus dipenuhi kontrol untuk menggunakan ControlTypeProperty properti . Kondisi ini mencakup pedoman khusus untuk struktur pohon UI Automation, nilai properti UI Automation, dan pola kontrol.
Kontrol tabel mengandung baris dan kolom teks, serta, sebagai pilihan, header baris dan header kolom.
Bagian berikut menentukan struktur pohon, properti, pola kontrol, dan peristiwa Otomasi UI yang diperlukan untuk jenis kontrol Tabel. Persyaratan Otomatisasi UI berlaku untuk semua kontrol tabel, baik Windows Presentation Foundation (WPF), Win32, atau Windows Forms.
Struktur Pohon Automasi UI yang Diperlukan
Tabel berikut ini menggambarkan tampilan kontrol dan tampilan konten pohon Automation UI yang berkaitan dengan kontrol tabel dan menjelaskan apa yang dapat dimuat dalam setiap tampilan. Untuk informasi selengkapnya tentang pohon Automation UI, lihat Gambaran Umum Pohon Automasi UI.
| Tampilan Kontrol | Tampilan Isi |
|---|---|
| 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 Otomatisasi UI. Tampilan Konten tidak perlu mengekspos informasi ini karena dapat diakses menggunakan TablePattern.
Properti Otomasi Antarmuka Pengguna yang Dibutuhkan
Tabel berikut mencantumkan properti Automation UI yang nilai atau definisinya sangat relevan dengan kontrol Tabel. Untuk informasi selengkapnya tentang properti Automation UI, lihat Properti Automasi UI untuk Klien.
| Properti Automasi Antarmuka Pengguna | 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 persegi panjang 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 statis. Jika tidak ada label teks statis, Anda harus menetapkan properti Nama yang harus selalu tersedia untuk menjelaskan tujuan tabel. |
| LabeledByProperty | Lihat catatan. | Jika ada label teks statis, properti ini harus mengekspos referensi ke elemen otomatisasi kontrol. |
| ControlTypeProperty | Tabel | Nilai ini sama untuk semua kerangka kerja UI. |
| LocalizedControlTypeProperty | “tabel” | String yang dilokalkan yang sesuai dengan tipe kontrol Tabel. |
| HelpTextProperty | Lihat catatan. | Detail 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 tetap sebagai elemen kontrol. |
Pola Kontrol Automasi UI 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 UI .
| Pola Kontrol | Dukungan | Catatan |
|---|---|---|
| IGridProvider | Ya | Kontrol tabel selalu mendukung pola kontrol ini karena item yang dikandungnya memiliki data yang disajikan dalam kisi. |
| IGridItemProvider | Ya (diperlukan dengan objek anak) | Objek dalam tabel harus mendukung pola kontrol GridItem dan TableItem. Tabel itu sendiri tidak perlu mendukung pola kontrol GridItem atau TableItem kecuali tabel adalah bagian dari tabel lain. |
| ITableProvider | Ya | Kontrol tabel selalu memiliki kemampuan memiliki header yang terkait dengan konten. |
| ITableItemProvider | Ya (diperlukan dengan objek anak) | Objek dalam tabel harus mendukung pola kontrol GridItem dan TableItem. Tabel itu sendiri tidak perlu mendukung pola kontrol GridItem atau TableItem kecuali tabel adalah bagian dari tabel lain. |
Peristiwa Automasi UI yang Diperlukan
Tabel berikut mencantumkan peristiwa Automasi UI yang diperlukan untuk didukung oleh semua kontrol tabel. Untuk informasi selengkapnya tentang peristiwa, lihat Gambaran Umum Peristiwa Automasi UI .
| Peristiwa UI Automation | Dukungan | Catatan |
|---|---|---|
| BoundingRectangleProperty acara perubahan properti. | Diperlukan | Tidak ada |
| IsOffscreenProperty acara perubahan properti. | Diperlukan | Tidak ada |
| IsEnabledProperty acara perubahan properti. | Diperlukan | Tidak ada |
| AutomationFocusChangedEvent | Diperlukan | Tidak ada |
| StructureChangedEvent | Diperlukan | Tidak ada |