Dukungan UI Automation untuk Jenis Kontrol ProgressBar
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 ProgressBar. 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, pola kontrol, dan peristiwa UI Automation.
Kontrol bilah progres adalah contoh kontrol yang menerapkan jenis kontrol ProgressBar. Kontrol bilah progres digunakan untuk menunjukkan progres operasi yang panjang. Kontrol terdiri dari persegi panjang yang secara bertahap diisi dengan warna sorotan sistem saat operasi berlangsung.
Bagian berikut menentukan struktur pohon UI Automation yang diperlukan, properti, pola kontrol, dan kejadian untuk jenis kontrol ProgressBar. Persyaratan UI Automation berlaku untuk semua kontrol daftar, 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 bilah progres dan menjelaskan hal yang dapat dimuat dalam setiap tampilan. Untuk informasi selengkapnya tentang pohon UI Automation, lihat Gambaran Umum Pohon UI Automation.
| Tampilan Kontrol | Tampilan Konten |
|---|---|
| ProgressBar | ProgressBar |
Kontrol bilah progres tidak memiliki turunan dalam kontrol atau tampilan konten dari pohon UI Automation.
Properti Azure Automation Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan properti UI Automation yang nilai atau definisinya sangat relevan dengan kontrol bilah progres. 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. | 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 bilah progres biasanya mendapatkan namanya dari label teks statis. Jika tidak ada label teks statis, pengembang aplikasi harus memaparkan nilai untuk properti Name. |
| LabeledByProperty | Lihat catatan. | Jika ada label teks statik, properti ini harus mengekspos referensi ke kontrol tersebut. |
| ControlTypeProperty | ProgressBar | Nilai ini sama untuk semua kerangka kerja UI. |
| LocalizedControlTypeProperty | "bilah progres" | String yang dilokalkan sesuai dengan jenis kontrol ProgressBar. |
| IsContentElementProperty | Benar | Kontrol bilah progres selalu disertakan dalam tampilan konten pohon UI Automation. |
| IsControlElementProperty | Benar | Kontrol bilah progres selalu disertakan dalam tampilan kontrol pohon UI Automation. |
Pola dan Properti Kontrol UI Automation yang Diperlukan
Tabel berikut mencantumkan pola kontrol UI Automation yang diperlukan untuk didukung oleh kontrol bilah progres. Untuk informasi selengkapnya tentang pola kontrol, lihat Gambaran Umum Pola Kontrol Automasi Antarmuka Pengguna.
| Pola Kontrol/Properti Pola | Dukungan/Nilai | Catatan |
|---|---|---|
| IValueProvider | Bergantung | Kontrol bilah progres yang memberikan indikasi progres tekstual harus menerapkan IValueProvider. |
| IsReadOnly | Benar | Nilai untuk properti ini selalu True. |
| Value | Lihat catatan. | Properti ini memperlihatkan progres tekstual dari kontrol bilah progres. |
| IRangeValueProvider | Bergantung | Kontrol bilah progres yang menggunakan rentang numerik harus menerapkan IRangeValueProvider |
| Minimum | 0.0 | Nilai properti ini adalah nilai terkecil yang dapat diatur oleh kontrol. |
| Maximum | 100,0 | Nilai properti ini adalah nilai terbesar yang dapat diatur oleh kontrol. |
| SmallChange | NaN | Properti ini tidak diperlukan karena kontrol bilah progres bersifat baca-saja. |
| LargeChange | NaN | Properti ini tidak diperlukan karena kontrol bilah progres bersifat baca-saja. |
Peristiwa UI Automation yang Diperlukan
Tabel berikut mencantumkan peristiwa UI Automation yang diperlukan untuk didukung oleh semua kontrol bilah progres. 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 |
| NameProperty peristiwa perubahan properti. | Wajib | Tidak |
| ValueProperty peristiwa perubahan properti. | Bergantung | Tidak |
| AutomationFocusChangedEvent | Wajib | Tidak |
| StructureChangedEvent | Wajib | Tidak |