Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
Not
Bu dokümantasyon, System.Windows.Automation ad alanında tanımlı olan yönetilen UI Otomasyon sınıflarını kullanmak isteyen .NET Framework geliştiricilerine yöneliktir. UI Otomasyonu hakkında en son bilgiler için bkz. Windows Otomasyonu API'si: UI Otomasyonu.
Bu makale, IScrollProvider uygulanmasına yönelik yönergeler ve kuralları tanıtır, olaylar ve özellikler hakkında bilgi içerir. Bu konunun sonunda ek referansların bağlantıları listelenir.
Bir alt nesne koleksiyonu için kaydırılabilir bir kapsayıcı işlevi gören bir denetimi desteklemek için ScrollPattern denetim düzeni kullanılır. Genellikle olsa da, kaydırma işlevini desteklemek için kaydırma çubuklarını kullanmak için denetim gerekli değildir.
Kaydırma Çubukları Kullanmayan Kaydırma Denetimi Örneği
Bu denetimi uygulayan denetim örnekleri için bkz. UI Otomasyonu İstemcileri için Denetim Düzeni Eşlemesi.
Uygulama Yönergeleri ve Kuralları
Kaydırma denetimi desenini uygularken aşağıdaki yönergelere ve kurallara dikkat edin:
Bu denetimin alt öğelerinin IScrollItemProvider uygulaması gerekir.
Kapsayıcı denetimin kaydırma çubukları, ScrollPattern denetim düzenini desteklemez. Bunun yerine RangeValuePattern kontrol düzenini desteklemeleri gerekir.
Kaydırma yüzde cinsinden ölçüldüğünde, kaydırma derecelendirmesiyle ilgili tüm değerler veya miktarlar 0 ile 100 arasında normalleştirilmelidir.
HorizontallyScrollableProperty ve VerticallyScrollablePropertyIsEnabledProperty'den bağımsızdır.
Eğer HorizontallyScrollableProperty =
falseise, HorizontalViewSizeProperty %100 olarak ayarlanmalıdır ve HorizontalScrollPercentProperty, NoScroll olarak ayarlanmalıdır. Benzer şekilde, bu VerticallyScrollableProperty =falsedurumda VerticalViewSizeProperty yüzde 100 olarak ayarlanmalıdır ve VerticalScrollPercentProperty olarak NoScrollayarlanmalıdır. Bir UI Otomasyonu istemcisinin, ilgi duymadığı bir kaydırma yönü etkinleştiğinde bir yarış durumu oluşmasını önleyerek, bu özellik değerlerini SetScrollPercent yönteminde kullanmasına olanak tanır.HorizontalScrollPercent yerel ayara özgüdür. HorizontalScrollPercent = 100.0 ayarı, denetimin kaydırma konumunu, soldan sağa okunan İngilizce gibi diller için en sağdaki konumuna eşdeğer olarak ayarlamalıdır. Alternatif olarak, sağdan sola okunan Arapça gibi diller için HorizontalScrollPercent = 100,0 ayarının kaydırma konumunu en soldaki konuma ayarlaması gerekir.
IScrollProvider için Gerekli Üyeler
uygulamak IScrollProvideriçin aşağıdaki özellikler ve yöntemler gereklidir.
| Gerekli üye | Üye türü | Notlar |
|---|---|---|
| HorizontalScrollPercent | Özellik | Hiçbiri |
| VerticalScrollPercent | Özellik | Hiçbiri |
| HorizontalViewSize | Özellik | Hiçbiri |
| VerticalViewSize | Özellik | Hiçbiri |
| HorizontallyScrollable | Özellik | Hiçbiri |
| VerticallyScrollable | Özellik | Hiçbiri |
| Scroll | Metot | Hiçbiri |
| SetScrollPercent | Metot | Hiçbiri |
Bu denetim deseninde ilişkili olay yok.
Özel durumlar
Sağlayıcıların aşağıdaki istisnaları oluşturması gerekir.
| Özel Durum Türü | Koşul |
|---|---|
| ArgumentException | Scroll yalnızca yatay veya dikey kaydırma için SmallIncrement değerlerini destekleyen bir denetime LargeIncrement değeri geçirilirse bu istisnayı atar. |
| ArgumentException | SetScrollPercent çifte dönüştürülemeyen bir değer geçirildiğinde bu özel durumu oluşturur. |
| ArgumentOutOfRangeException | SetScrollPercent 100'den büyük veya 0'dan küçük bir değer geçirildiğinde (eşdeğeri NoScroll-1 dışında) bu özel durumu oluşturur. |
| InvalidOperationException | Hem Scroll hem de SetScrollPercent, desteklenmeyen bir yönde kaydırma girişiminde bulunulduğunda bu istisnayı atar. |