Bagikan melalui


Menerapkan Pola Kontrol Nilai Rentang Otomatisasi UI

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 memperkenalkan panduan dan konvensi untuk menerapkan IRangeValueProvider, termasuk informasi tentang peristiwa dan properti. Tautan ke referensi tambahan tercantum di akhir topik.

Pola RangeValuePattern kontrol digunakan untuk mendukung kontrol yang dapat diatur ke nilai dalam rentang. Untuk contoh kontrol yang menerapkan pola kontrol ini, lihat Pemetaan Pola Kontrol untuk Klien Automasi UI.

Pedoman dan Konvensi Implementasi

Saat menerapkan pola kontrol Nilai Rentang, perhatikan panduan dan konvensi berikut:

  • Kontrol memungkinkan kalibrasi ulang properti yang didukung berdasarkan preferensi lokal atau pengguna. Contohnya adalah kontrol termometer yang dapat diatur untuk menampilkan suhu di Fahrenheit atau Celcius.

  • Kontrol yang memiliki nilai rentang ambigu, seperti bilah kemajuan atau penggelser, harus memiliki nilai-nilai yang dinormalisasi.

Bilah kemajuan. Contoh Bilah Kemajuan di mana nilai bertipe bilangan bulat dan nilai properti minimum dan maksimum yang masing-masing dinormalisasi menjadi 0 dan 100

Anggota yang Diperlukan untuk IRangeValueProvider

Anggota yang diperlukan Jenis anggota Catatan
IsReadOnlyProperty Harta benda Tidak ada
ValueProperty Harta benda Tidak ada
LargeChangeProperty Harta benda Tidak ada
SmallChangeProperty Harta benda Tidak ada
MaximumProperty Harta benda Tidak ada
MinimumProperty Harta benda Tidak ada
SetValue Metode Tidak ada

Pola kontrol ini tidak memiliki peristiwa terkait.

Pengecualian

Penyedia harus memberikan pengecualian berikut.

Jenis pengecualian Keadaan
ArgumentOutOfRangeException SetValue dipanggil dengan nilai yang lebih besar dari MaximumProperty atau kurang dari MinimumProperty.

Lihat juga