Menerapkan pola kontrol gulir UI Automation

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.

Artikel ini memperkenalkan panduan dan konvensi untuk menerapkan IScrollProvider, termasuk informasi tentang peristiwa dan properti. Link ke referensi tambahan tercantum di akhir topik.

Pola kontrol ScrollPattern digunakan untuk mendukung kontrol yang berfungsi sebagai wadah yang dapat digulir untuk kumpulan objek turunan. Kontrol tidak harus menggunakan bilah gulir untuk mendukung fungsi bergulir, meskipun biasanya memang digunakan.

Contoh Pengendalian Pengguliran yang Tidak Menggunakan Bilah Gulir

Untuk contoh kontrol yang menerapkan kontrol ini, baca Pemetaan Pola Kontrol untuk Klien UI Automation.

Pedoman dan Konvensi Implementasi

Saat menerapkan pola kontrol Gulir, perhatikan panduan dan konvensi berikut:

• Anak kontrol ini harus menerapkan IScrollItemProvider.

• Bilah gulir kontrol kontainer tidak mendukung pola kontrol ScrollPattern. Sebagai gantinya, mereka harus mendukung pola kontrol RangeValuePattern.

• Saat pengguliran diukur dalam persentase, semua nilai atau jumlah yang terkait dengan pembagian gulir harus dinormalisasi ke rentang 0 hingga 100.

• HorizontallyScrollableProperty dan VerticallyScrollableProperty tidak bergantung pada IsEnabledProperty.

• Jika HorizontallyScrollableProperty = false maka HorizontalViewSizeProperty harus diatur ke 100% dan HorizontalScrollPercentProperty harus diatur ke NoScroll. Sama halnya, jika VerticallyScrollableProperty = false maka VerticalViewSizeProperty harus diatur ke 100 persen dan VerticalScrollPercentProperty harus diatur ke NoScroll. Ini memungkinkan klien UI Automation untuk menggunakan nilai properti ini pada SetScrollPercent metode sambil menghindari kondisi balapan jika arah yang tidak diminati oleh klien untuk digulir diaktifkan.

• HorizontalScrollPercent bersifat khusus lokal. Menetapkan HorizontalScrollPercent = 100.0 harus mengatur lokasi pengguliran kontrol ke posisi paling kanan yang setara untuk bahasa seperti Inggris, yang dibaca dari kiri ke kanan. Sebagai alternatif, untuk bahasa seperti bahasa Arab yang membaca dari kanan ke kiri, setelan HorizontalScrollPercent = 100.0 harus mengatur lokasi gulir ke posisi paling kiri.

Anggota yang Diperlukan untuk IScrollProvider

Properti dan metode berikut diperlukan untuk mengimplementasikan IScrollProvider.

Anggota yang diperlukan	Jenis anggota	Catatan
HorizontalScrollPercent	Properti	Tidak
VerticalScrollPercent	Properti	Tidak
HorizontalViewSize	Properti	Tidak
VerticalViewSize	Properti	Tidak
HorizontallyScrollable	Properti	Tidak
VerticallyScrollable	Properti	Tidak
Scroll	Metode	Tidak
SetScrollPercent	Metode	Tidak

Pola kontrol ini tidak memiliki peristiwa terkait.

Pengecualian

Penyedia harus menampilkan pengecualian berikut.

Tipe Pengecualian	Kondisi
ArgumentException	Scroll melempar pengecualian ini jika kontrol mendukung nilai SmallIncrement khusus untuk pengguliran horizontal atau vertikal, tetapi nilai LargeIncrement diteruskan.
ArgumentException	SetScrollPercent menghasilkan pengecualian ini ketika nilai yang tidak dapat dikonversi menjadi double diteruskan.
ArgumentOutOfRangeException	SetScrollPercent menampilkan pengecualian ini jika nilai yang lebih besar dari 100 atau kurang dari 0 diteruskan (kecuali -1 yang sama dengan NoScroll).
InvalidOperationException	Scroll dan SetScrollPercent menampilkan pengecualian ini jika upaya dilakukan untuk menggulir ke arah yang tidak didukung.

Lihat juga

• Gambaran Umum Pola Kontrol Automasi Antarmuka Pengguna
• Mendukung Pola Kontrol pada Penyedia Otomasi UI
• Pola Kontrol UI Automation untuk Klien
• Gambaran Umum Pohon UI Automation
• Gunakan Cache di UI Automation