Dukungan Automasi Antarmuka Pengguna untuk Jenis Kontrol Penggeser
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 Automasi Antarmuka Pengguna untuk jenis kontrol Penggeser. Dalam UI Automation, jenis kontrol adalah kumpulan kondisi yang harus dipenuhi kontrol untuk menggunakan properti ControlTypeProperty. Kondisi ini mencakup pedoman khusus untuk struktur pohon Automasi Antarmuka Pengguna, Automasi Antarmuka Pengguna Automasi Antarmuka Pengguna nilai properti dan jenis kontrol.
Kontrol Penggeser adalah kontrol komposit dengan tombol yang memungkinkan pengguna dengan mouse untuk mengatur rentang numerik atau memilih dari satu set item.
Bagian berikut menentukan struktur pohon, properti, pola kontrol, dan peristiwa yang diperlukan Automasi Antarmuka Pengguna untuk jenis kontrol Penggeser. Persyaratan Automasi Antarmuka Pengguna berlaku untuk semua kontrol penggeser, baik Windows Presentation Foundation (WPF), Win32, atau Formulir Windows.
Struktur Pohon UI Automation yang Diperlukan
Tabel berikut menggambarkan Tampilan Kontrol dan Tampilan Konten pohon Automasi Antarmuka Pengguna yang berkaitan dengan kontrol penggeser dan menjelaskan apa yang dapat terkandung dalam setiap tampilan. Untuk informasi selengkapnya tentang pohon UI Automation, lihat Gambaran Umum Pohon UI Automation.
| Tampilan Kontrol | Tampilan Konten |
|---|---|
| Penggeser - Tombol (2 atau 4) - Jempol (hanya 1) - Daftar Item (0 atau lebih) |
Penggeser - Daftar Item (0 atau lebih) |
Properti Azure Automation Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan properti Automasi Antarmuka Pengguna yang nilai atau definisinya sangat relevan dengan jenis kontrol Penggeser. 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 | Melihat catatan | Sebagian besar kontrol penggeser harus menaikkan NoClickablePointException karena seluruh kotak batas kontrol penggeser ditempati oleh kontrol turunan. |
| IsKeyboardFocusableProperty | Lihat catatan. | Jika kontrol dapat menerima fokus keyboard, maka kontrol harus mendukung properti ini. |
| NameProperty | Lihat catatan. | Nama kontrol edit biasanya dihasilkan dari label teks statis. Jika tidak ada label teks statik, nilai properti untuk Name harus ditetapkan oleh pengembang aplikasi. Properti Name tidak boleh memuat konten tekstual kontrol pengeditan. |
| LabeledByProperty | Lihat catatan. | Jika ada label teks statis yang terkait dengan kontrol, maka properti ini harus mengekspos referensi ke kontrol tersebut. Jika kontrol teks adalah subkomponen dari kontrol lain, kontrol teks tidak akan memiliki kumpulan properti LabeledBy. |
| ControlTypeProperty | Penggeser | Nilai ini sama untuk semua kerangka kerja UI. |
| LocalizedControlTypeProperty | "penggeser" | String lokal yang sesuai dengan Jenis Kontrol Edit. |
| IsContentElementProperty | Benar | Kontrol edit selalu disertakan dalam tampilan konten pohon Automasi Antarmuka Pengguna. |
| IsControlElementProperty | Benar | Kontrol pengeditan selalu disertakan dalam tampilan kontrol pohon UI Automation. |
Pola Kontrol Automasi Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan pola kontrol Automasi Antarmuka Pengguna yang diperlukan untuk didukung oleh semua kontrol penggeser. Untuk informasi selengkapnya tentang pola kontrol, lihat Gambaran Umum Pola Kontrol Automasi Antarmuka Pengguna.
| Pola Kontrol | Dukungan | Catatan |
|---|---|---|
| ISelectionProvider | Bergantung | Penggeser harus mendukung pola kontrol Seleksi jika konten mewakili satu nilai di antara serangkaian opsi diskrit. Ketika pola kontrol Seleksi didukung, pilihan yang sesuai harus diekspos sebagai satu atau lebih item daftar turunan penggeser. |
| IRangeValueProvider | Bergantung | Penggeser harus mendukung pola kontrol RangeValue jika konten dapat diatur ke nilai dalam rentang numerik. |
| IValueProvider | Bergantung | Penggeser harus mendukung pola kontrol Nilai jika konten mewakili satu nilai di antara serangkaian opsi diskrit. |
Peristiwa UI Automation yang Diperlukan
Tabel berikut mencantumkan peristiwa Automasi Antarmuka Pengguna yang harus didukung oleh semua kontrol penggeser.
Untuk informasi selengkapnya tentang acara, baca Gambaran Umum Peristiwa UI Automation.
| Peristiwa UI Automation | Dukungan | Catatan |
|---|---|---|
| InvalidatedEvent | Bergantung | Tidak |
| BoundingRectangleProperty peristiwa yang diubah properti | Wajib | Tidak |
| IsOffscreenProperty peristiwa yang diubah properti | Wajib | Tidak |
| IsEnabledProperty peristiwa yang diubah properti | Wajib | Tidak |
| ValueProperty peristiwa yang diubah properti | Bergantung | Tidak |
| AutomationFocusChangedEvent | Wajib | Tidak |
| StructureChangedEvent | Wajib | Tidak |