Dukungan UI Automation untuk Jenis Kontrol Grup
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 Grup. Dalam UI Automation, jenis kontrol adalah kumpulan kondisi yang harus dipenuhi kontrol untuk menggunakan properti ControlTypeProperty. Ketentuan tersebut mencakup panduan khusus untuk struktur pohon UI Automation, nilai properti UI Automation, dan pola kontrol UI Automation.
Kontrol grup mewakili simpul dalam hierarki. Tipe kontrol grup membuat pemisahan di pohon otomatisasi UI sehingga item yang dikelompokkan bersama memiliki pembagian logis dalam pohon UI Automation.
Bagian berikut menentukan struktur pohon UI Automation, properti, pola kontrol, dan peristiwa yang diperlukan untuk tipe kontrol Grup. Persyaratan UI Automation berlaku untuk semua kontrol grup, baik Windows Presentation Foundation (WPF), Win32, atau Formulir Windows.
Struktur Pohon UI Automation yang Diperlukan
Tabel berikut menggambarkan tampilan kontrol dan tampilan konten dari pohon UI Automation yang berkaitan dengan kontrol grup dan menjelaskan apa yang dapat dimuat dalam setiap tampilan. Untuk informasi selengkapnya tentang pohon UI Automation, lihat Gambaran Umum Pohon UI Automation.
| Tampilan Kontrol | Tampilan Konten |
|---|---|
| Grupkan - 0 atau banyak kontrol |
Grupkan - 0 atau banyak kontrol |
Biasanya kontrol grup akan memiliki jenis kontrol Dukungan UI Automation untuk Tipe Kontrol ListItem, Dukungan UI Automation untuk Tipe Kontrol TreeItem, atau Dukungan UI Automation untuk Tipe Kontrol DataItem yang berada di bawahnya di sub pohon. Karena 'Grup' adalah wadah generik, semua jenis kontrol dapat berada di bawah kontrol Grup di pohon.
Properti Azure Automation Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan properti UI Automation yang nilai atau definisinya sangat relevan dengan kontrol grup. 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 grup biasanya mendapatkan namanya dari teks yang melabeli kontrol. |
| LabeledByProperty | Lihat catatan. | Kontrol grup biasanya pelabelan diri. Dalam kasus ini, kembalikan null di sini. Jika ada label teks statis untuk grup, label harus dikembalikan sebagai nilai properti LabeledBy. |
| ControlTypeProperty | Grupkan | Nilai ini sama untuk semua kerangka kerja UI. |
| LocalizedControlTypeProperty | "grup" | String yang dilokalkan sesuai dengan tipe kontrol Grup. |
| IsContentElementProperty | Benar | Kontrol grup selalu disertakan dalam tampilan konten pohon UI Automation. |
| IsControlElementProperty | Benar | Grup kalender selalu disertakan dalam tampilan kontrol pohon UI Automation. |
Pola Kontrol Automasi Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan pola kontrol UI Automation yang diperlukan untuk didukung untuk tipe kontrol grup. Untuk mendapatkan informasi selengkapnya tentang pola kontrol, lihat Gambaran Umum Pola Kontrol UI Automation.
| Pola Kontrol | Dukungan | Catatan |
|---|---|---|
| IExpandCollapseProvider | Bergantung | Kontrol grup yang dapat digunakan untuk menampilkan atau menyembunyikan informasi harus mendukung pola Luaskan Ciutkan. |
Peristiwa UI Automation yang Diperlukan
Tabel berikut mencantumkan peristiwa UI Automation yang diperlukan untuk didukung oleh semua kontrol grup. Untuk mendapatkan informasi selengkapnya tentang peristiwa, lihat 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 |
| ExpandCollapseStateProperty peristiwa perubahan properti. | Bergantung | Tidak |
| ToggleStateProperty peristiwa perubahan properti. | Bergantung | Tidak |
| AutomationFocusChangedEvent | Wajib | Tidak |
| StructureChangedEvent | Wajib | Tidak |