Bagikan melalui

Dukungan Otomatisasi UI untuk Jenis Kontrol Bilah Kemajuan

Nota

Dokumentasi ini ditujukan untuk pengembang .NET Framework yang ingin menggunakan kelas Automation UI terkelola yang ditentukan dalam namespace System.Windows.Automation. Untuk informasi terbaru tentang Automasi UI, lihat Windows Automation API: UI Automation.

Topik ini menyediakan informasi tentang dukungan Automation UI untuk jenis kontrol ProgressBar. Di Automasi UI, jenis kontrol adalah serangkaian kondisi yang harus dipenuhi kontrol untuk menggunakan ControlTypeProperty properti . Kondisi ini termasuk pedoman khusus untuk struktur pohon Otomatisasi UI, nilai properti Otomatisasi UI, pola pengendalian, dan peristiwa Otomatisasi UI.

Kontrol bilah kemajuan adalah contoh kontrol yang mengimplementasikan jenis kontrol ProgressBar. Kontrol bilah kemajuan digunakan untuk 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 Otomasi UI yang diperlukan untuk jenis kontrol ProgressBar. Persyaratan Otomatisasi UI berlaku untuk semua kontrol daftar, baik Windows Presentation Foundation (WPF), Win32, atau Windows Forms.

Struktur Pohon Automasi UI yang Diperlukan

Tabel berikut ini menggambarkan tampilan kontrol dan tampilan konten dari pohon UI Automation terkait kontrol pada bilah kemajuan dan memberikan penjelasan mengenai isi setiap tampilan. Untuk informasi selengkapnya tentang pohon Automation UI, lihat Gambaran Umum Pohon Automasi UI.

Tampilan Kontrol Tampilan Isi
Bilah Kemajuan Bilah Kemajuan

Kontrol bilah kemajuan tidak memiliki turunan dalam tampilan kontrol atau konten pohon Automation UI.

Properti Otomasi Antarmuka Pengguna yang Dibutuhkan

Tabel berikut mencantumkan properti Automation UI yang nilai atau definisinya sangat relevan dengan kontrol bilah kemajuan. Untuk informasi selengkapnya tentang properti Automation UI, lihat Properti Automasi UI untuk Klien.

Properti Automasi Antarmuka Pengguna Nilai Catatan
AutomationIdProperty Lihat catatan. Nilai properti ini harus unik di semua kontrol dalam aplikasi.
BoundingRectangleProperty Lihat catatan. Persegi panjang terluar yang berisi seluruh kontrol.
ClickablePointProperty Lihat catatan. Didukung jika ada persegi panjang pembatas. Jika tidak setiap titik dalam persegi panjang 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, kontrol harus mendukung properti ini.
NameProperty 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 .Name
LabeledByProperty Lihat catatan. Jika ada label teks statis, maka properti ini harus mengekspos referensi ke kontrol tersebut.
ControlTypeProperty Bilah Kemajuan Nilai ini sama untuk semua kerangka kerja UI.
LocalizedControlTypeProperty "bilah kemajuan" String yang dilokalkan sesuai dengan jenis kontrol ProgressBar.
IsContentElementProperty Benar Kontrol bilah kemajuan selalu disertakan dalam tampilan konten pohon Automation UI.
IsControlElementProperty Benar Kontrol bilah kemajuan selalu disertakan dalam tampilan kontrol pohon Automation UI.

Pola dan Properti Kontrol Automasi UI 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
IValueProvider Bergantung Kontrol bilah kemajuan yang memberikan indikasi kemajuan secara tekstual harus menerapkan IValueProvider.
IsReadOnly Benar Nilai untuk properti ini selalu Benar.
Value Lihat catatan. Properti ini mengekspos kemajuan tekstual kontrol bilah kemajuan.
IRangeValueProvider Bergantung Kontrol bilah kemajuan dengan rentang numerik harus diimplementasikan IRangeValueProvider
Minimum 0.0 Nilai properti ini adalah nilai terkecil yang dapat diatur kontrolnya.
Maximum 100,0 Nilai properti ini adalah nilai terbesar yang dapat diatur oleh kontrol.
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.

Peristiwa Automasi UI yang Diperlukan

Tabel berikut mencantumkan peristiwa Otomatisasi Antarmuka Pengguna yang diperlukan untuk didukung oleh semua kontrol bilah kemajuan. Untuk informasi selengkapnya tentang peristiwa, lihat Gambaran Umum Peristiwa Automasi UI .

Peristiwa Automasi UI Dukungan Catatan
BoundingRectangleProperty acara perubahan properti. Diperlukan Tidak ada
IsOffscreenProperty acara perubahan properti. Diperlukan Tidak ada
IsEnabledProperty acara perubahan properti. Diperlukan Tidak ada
NameProperty acara perubahan properti. Diperlukan Tidak ada
ValueProperty acara perubahan properti. Bergantung Tidak ada
AutomationFocusChangedEvent Diperlukan Tidak ada
StructureChangedEvent Diperlukan Tidak ada

Lihat juga

  • Last updated on