Dukungan UI Automation untuk Jenis Kontrol Pemutar
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 jenis kontrol Pemutar. 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 pemutar digunakan untuk memilih dari domain item atau rentang angka.
Bagian berikut menentukan struktur pohon UI Automation yang diperlukan, properti, pola kontrol, dan kejadian untuk jenis kontrol Pemutar. Persyaratan UI Automation berlaku untuk semua kontrol pemutar, 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 pemutar saat keduanya mendukung pola kontrol Nilai Rentang, Nilai, dan Pilihan serta menjelaskan hal yang dapat dimuat dalam setiap tampilan. Untuk informasi selengkapnya tentang pohon UI Automation, lihat Gambaran Umum Pohon UI Automation.
Rentang Nilai atau Pola kontrol Nilai
| Tampilan Kontrol | Tampilan Konten |
|---|---|
| Spinner - Edit (0 atau 1) - Tombol (2) |
Spinner |
Pola kontrol pemilihan
| Tampilan Kontrol | Tampilan Konten |
|---|---|
| Spinner - Edit (0 atau 1) - Tombol (2) - Daftar Item (0 atau lebih) |
Spinner - ListItem (0 atau lebih) |
Untuk memastikan bahwa dua tombol dalam subtree tampilan kontrol dapat dibedakan oleh alat pengujian otomatis, tetapkan SmallIncrement atau SmallDecrement AutomationId yang sesuai. Untuk beberapa implementasi, kontrol Edit terkait mungkin merupakan rekan dari kontrol Pemutar.
Properti Azure Automation Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan properti UI Automation yang nilai atau definisinya sangat relevan dengan kontrol pemutar. Untuk 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. | Titik kontrol pemutar yang dapat diklik memberikan fokus ke bagian edit kontrol. |
| IsKeyboardFocusableProperty | Lihat catatan. | Jika kontrol dapat menerima fokus keyboard, maka kontrol harus mendukung properti ini. |
| NameProperty | Lihat catatan. | Kontrol pemutar biasanya mendapatkan namanya dari label teks statis. |
| LabeledByProperty | Lihat catatan. | Kontrol pemutar memiliki label teks statis. |
| ControlTypeProperty | Spinner | Nilai ini sama untuk semua kerangka kerja UI. |
| LocalizedControlTypeProperty | "pemutar" | String yang dilokalkan sesuai dengan jenis kontrol Pemutar. |
| IsContentElementProperty | Benar | Kontrol pemutar harus selalu berupa konten. |
| IsControlElementProperty | Benar | Kontrol Pemutar harus selalu berupa kontrol. |
Pola dan Properti Kontrol UI Automation yang Diperlukan
Tabel berikut mencantumkan pola kontrol UI Automation yang diperlukan untuk didukung oleh kontrol pemutar. Untuk mendapatkan informasi selengkapnya tentang pola kontrol, lihat Gambaran Umum Pola Kontrol UI Automation.
| Pola Kontrol/Properti Pola | Dukungan/Nilai | Catatan |
|---|---|---|
| ISelectionProvider | Bergantung | Kontrol pemutar yang memiliki daftar item yang akan dipilih harus mendukung pola ini. |
| CanSelectMultiple | Salah | Kontrol pemutar selalu merupakan kontainer pilihan tunggal. |
| IRangeValueProvider | Bergantung | Kontrol pemutar yang menjangkau rentang numerik dapat mendukung pola ini. |
| IValueProvider | Bergantung | Kontrol pemutar yang mencakup serangkaian opsi atau angka terpisah dapat mendukung pola ini. |
Peristiwa UI Automation yang Diperlukan
Tabel berikut mencantumkan peristiwa UI Automation yang diperlukan untuk didukung oleh semua kontrol pemutar. Untuk informasi selengkapnya tentang acara, baca Gambaran Umum Peristiwa UI Automation.
| Peristiwa UI Automation | Dukungan | Catatan |
|---|---|---|
| InvalidatedEvent | Bergantung | Tidak |
| BoundingRectangleProperty peristiwa perubahan properti. | Wajib | Tidak |
| IsOffscreenProperty peristiwa perubahan properti. | Wajib | Tidak |
| IsEnabledProperty peristiwa perubahan properti. | Wajib | Tidak |
| ValueProperty peristiwa perubahan properti. | Bergantung | Tidak |
| ValueProperty peristiwa perubahan properti. | Bergantung | Tidak |
| AutomationFocusChangedEvent | Wajib | Tidak |
| StructureChangedEvent | Wajib | Tidak |