Pola Kontrol Gulir

Menjelaskan panduan dan konvensi untuk menerapkan IScrollProvider, termasuk informasi tentang properti dan metode. Pola kontrol Gulir digunakan untuk mendukung kontrol yang bertindak sebagai kontainer yang dapat digulir untuk kumpulan objek anak.

Kontrol tidak diperlukan untuk menggunakan bilah gulir untuk mendukung fungsionalitas pengguliran, meskipun biasanya. Gambar berikut menunjukkan kontrol gulir yang tidak menggunakan bilah gulir. Untuk contoh kontrol yang menerapkan pola kontrol ini, lihat Jenis Kontrol dan Pola Kontrol yang Didukung.

Topik ini berisi bagian berikut.

• Panduan dan Konvensi Implementasi
• Anggota yang Diperlukan untuk IScrollProvider
• Topik terkait

Panduan dan Konvensi Implementasi

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

• Anak-anak kontrol ini harus menerapkan IScrollItemProvider.
• Bilah gulir kontrol kontainer tidak mendukung pola kontrol Gulir . Mereka harus mendukung pola kontrol RangeValue sebagai gantinya.
• Saat pengguliran diukur dalam persentase, semua nilai atau jumlah yang terkait dengan kelulusan gulir harus dinormalisasi ke rentang 0 hingga 100.
• Properti IScrollProvider::HorizontallyScrollable dan VerticallyScrollable tidak bergantung pada properti IsEnabled .
• Jika properti IScrollProvider::HorizontallyScrollableFALSE, properti HorizontalViewSize harus diatur ke properti 100 (100%) dan HorizontalScrollPercent harus diatur ke UIA_ScrollPatternNoScroll (-1). Demikian juga, jika properti VerticallyScrollableFALSE, properti VerticalViewSize harus diatur ke 100 (100%) dan properti VerticalScrollPercent harus diatur ke UIA_ScrollPatternNoScroll (-1). Ini memungkinkan klien Microsoft UI Automation untuk menggunakan nilai properti ini dalam metode SetScrollPercent sambil menghindari kondisi balapan jika arah klien tidak tertarik untuk menggulir menjadi diaktifkan.
• Properti IScrollProvider::HorizontalScrollPercent khusus lokal. Mengatur HorizontalScrollPercent ke 100 harus mengatur lokasi pengguliran kontrol ke setara dengan posisi paling kanan untuk bahasa seperti bahasa Inggris yang membaca dari kiri ke kanan. Sebagai alternatif, untuk bahasa seperti Arab yang membaca kanan ke kiri, mengatur HorizontalScrollPercent ke 100 harus mengatur lokasi gulir ke posisi paling kiri.

Anggota yang Diperlukan untuk IScrollProvider

Properti dan metode berikut diperlukan untuk mengimplementasikan antarmuka IScrollProvider .

Anggota yang diperlukan	Jenis anggota	Catatan
HorizontalScrollPercent	Properti	Tidak ada
VerticalScrollPercent	Properti	Tidak ada
HorizontalViewSize	Properti	Tidak ada
VertikalViewSize	Properti	Tidak ada
HorizontallyScrollable	Properti	Tidak ada
VertikallyScrollable	Properti	Tidak ada
Gulir	Metode	Tidak ada
SetScrollPercent	Metode	Tidak ada

 

Pola kontrol ini tidak memiliki peristiwa terkait.

Topik terkait

Jenis Kontrol dan Pola Kontrol yang Didukung

Gambaran Umum Pola Kontrol UI Automation

Gambaran Umum Pohon UI Automation