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.
Topik ini menyediakan informasi tentang dukungan Microsoft UI Automation untuk ProgressBar jenis kontrol.
Kontrol bilah kemajuan menunjukkan kemajuan operasi yang panjang. Kontrol terdiri dari persegi panjang yang secara bertahap diisi dengan warna sorotan sistem saat operasi berlangsung.
Bagian berikut menentukan struktur pohon, properti, pola kontrol, dan peristiwa Automation UI yang diperlukan untuk ProgressBar jenis kontrol. Persyaratan Automasi UI berlaku untuk semua kontrol bilah kemajuan di mana kerangka kerja/platform UI mengintegrasikan dukungan Automation UI untuk jenis kontrol dan pola kontrol.
Topik ini berisi bagian berikut.
- Struktur Pohon Umum
- properti yang relevan
- Pola Kontrol yang Diperlukan
- Peristiwa yang Diperlukan
- Topik terkait
Struktur Pohon Umum
Tabel berikut ini menggambarkan kontrol umum dan tampilan konten pohon Automation UI yang berkaitan dengan kontrol bilah kemajuan 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 |
|---|---|
|
|
Kontrol bilah kemajuan tidak memiliki turunan dalam tampilan kontrol atau konten pohon Automation UI.
Properti yang Relevan
Tabel berikut mencantumkan properti Automation UI yang nilai atau definisinya sangat relevan dengan bilah kemajuan. Untuk informasi selengkapnya tentang properti Automation UI, lihat Mengambil Properti dari Elemen Automation UI.
| Properti Automasi UI | Nilai | Catatan |
|---|---|---|
| UIA_AutomationIdPropertyId | Lihat catatan. | Nilai properti ini harus unik di antara semua elemen serekan dalam tampilan mentah pohon Automation UI. |
| UIA_BoundingRectanglePropertyId | Lihat catatan. | Persegi panjang terluar yang berisi seluruh kontrol. |
| UIA_ClickablePointPropertyId | Lihat catatan. | Didukung jika ada persegi panjang pembatas. Jika tidak setiap titik dalam persegi panjang pembatas dapat diklik, dan elemen melakukan pengujian hit khusus, ambil alih dan berikan titik yang dapat diklik. |
| UIA_ControlTypePropertyId | ProgressBar | |
| UIA_IsContentElementPropertyId | TRUE | Kontrol bilah kemajuan selalu disertakan dalam tampilan konten pohon Automation UI. |
| UIA_IsControlElementPropertyId | TRUE | Kontrol bilah kemajuan selalu disertakan dalam tampilan kontrol pohon Automation UI. |
| UIA_IsKeyboardFocusablePropertyId | Lihat catatan. | Jika kontrol dapat menerima fokus keyboard, kontrol harus mendukung properti ini. |
| UIA_LabeledByPropertyId | Lihat catatan. | Jika ada label teks statis, properti ini harus mengekspos referensi ke kontrol tersebut. |
| UIA_LocalizedControlTypePropertyId | Lihat catatan. | String yang dilokalkan sesuai dengan jenis kontrol ProgressBar. Nilai defaultnya adalah "bilah kemajuan" untuk en-US atau Inggris (Amerika Serikat). |
| UIA_NamePropertyId | Lihat catatan. | Kontrol bilah kemajuan biasanya mendapatkan namanya dari label teks statis. Jika tidak ada label teks statis, pengembang aplikasi harus mengekspos nilai untuk properti Nama. |
Pola Kontrol yang Diperlukan
Tabel berikut mencantumkan pola kontrol Automation UI yang diperlukan untuk didukung oleh kontrol bilah kemajuan. Untuk informasi selengkapnya tentang pola kontrol, lihat Gambaran Umum Pola Kontrol Automasi UI .
| Properti Pola/Pola Kontrol | Dukungan/Nilai | Catatan |
|---|---|---|
| IRangeValueProvider | Tergantung | Kontrol bilah kemajuan yang mengambil rentang numerik harus menerapkan pola kontrol RangeValue. |
| Minimum | Tergantung | Nilai properti ini adalah nilai minimum yang dapat diatur kontrolnya. Nilai ini harus kurang dari Maksimum. |
| Maksimum | Tergantung | Nilai properti ini adalah nilai maksimum yang dapat diatur oleh kontrol. Nilai ini harus lebih besar dari Minimum . |
| SmallChange | NaN | Properti ini tidak diperlukan karena kontrol bilah kemajuan bersifat baca-saja. |
| LargeChange | NaN | Properti ini tidak diperlukan karena kontrol bilah kemajuan bersifat baca-saja. |
| IValueProvider | Tergantung | Kontrol bilah kemajuan yang memberikan indikasi tekstual kemajuan harus menerapkan pola kontrol Nilai. |
| IsReadOnly | TRUE | Nilai untuk properti ini selalu TRUE. |
| Nilai | Lihat catatan. | Properti ini mengekspos kemajuan tekstual kontrol bilah kemajuan. |
Peristiwa yang Diperlukan
Tabel berikut mencantumkan peristiwa Automasi UI yang diperlukan bilah kemajuan untuk didukung. Untuk informasi selengkapnya tentang peristiwa, lihat Gambaran Umum Peristiwa Automasi UI .
| Peristiwa Automasi UI | Catatan |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId peristiwa yang diubah properti. | |
| UIA_IsEnabledPropertyId peristiwa yang diubah properti. | Jika kontrol mendukung propertiIsEnabled, kontrol harus mendukung peristiwa ini. |
| UIA_IsOffscreenPropertyId peristiwa yang diubah properti. | Jika kontrol mendukung propertiIsOffscreen, kontrol harus mendukung peristiwa ini. |
| UIA_NamePropertyId peristiwa yang diubah properti. | |
| UIA_StructureChangedEventId | |
| UIA_RangeValueValuePropertyId peristiwa yang diubah properti. | Jika kontrol mendukung pola kontrol RangeValue, kontrol harus mendukung kejadian ini. |
| UIA_ValueValuePropertyId peristiwa yang diubah properti. | Jika kontrol mendukung pola kontrol Nilai, kontrol harus mendukung peristiwa ini. |
Topik terkait
-
Konseptual