UI Otomasyonu Kaydırma Denetim Düzenini Uygulama
Not
Bu belgeler, ad alanında tanımlanan yönetilen UI Otomasyonu sınıflarını kullanmak isteyen .NET Framework geliştiricilerine System.Windows.Automation yöneliktir. UI Otomasyonu hakkında en son bilgiler için bkz. Windows Otomasyonu API'si: UI Otomasyonu.
Bu konu başlığında, olaylar ve özellikler hakkında bilgiler de dahil olmak üzere uygulama IScrollProvideryönergeleri ve kuralları tanıtılmaktadır. Ek başvuruların bağlantıları, konunun sonunda listelenir.
Denetim ScrollPattern düzeni, bir alt nesne koleksiyonu için kaydırılabilir kapsayıcı işlevi gören bir denetimi desteklemek için 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 uygulaması IScrollItemProvidergerekir.
Kapsayıcı denetiminin kaydırma çubukları denetim düzenini desteklemez ScrollPattern . Bunun yerine denetim düzenini desteklemeleri RangeValuePattern gerekir.
Kaydırma yüzde cinsinden ölçüldüyse, kaydırma mezuniyeti ile ilgili tüm değerler veya tutarlar 0 ile 100 arasında bir aralıkta normalleştirilmelidir.
HorizontallyScrollableProperty ve VerticallyScrollableProperty bağımsızdır IsEnabledProperty.
Daha HorizontallyScrollableProperty =
falsesonra HorizontalViewSizeProperty %100 olarak ayarlanmalıdır ve HorizontalScrollPercentProperty olarak ayarlanmalıdır NoScroll. Benzer şekilde, bu VerticallyScrollableProperty =falsedurumda VerticalViewSizeProperty yüzde 100 olarak ayarlanmalıdır ve VerticalScrollPercentProperty olarak NoScrollayarlanmalıdır. Bu, UI Otomasyonu istemcisinin kaydırmayla ilgilenmediği bir yönün SetScrollPercent etkinleştirilmesi durumunda bir yarış durumundan kaçınırken yönteminde bu özellik değerlerini 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 özel durumları oluşturması gerekir.
| Özel Durum Türü | Koşul |
|---|---|
| ArgumentException | Scroll bir denetim değerleri yalnızca yatay veya dikey kaydırma için destekliyorsa SmallIncrement , ancak bir LargeIncrement değer geçirilirse bu özel durumu oluşturur. |
| 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 | SetScrollPercent Hem hem de Scroll desteklenmeyen bir yönde kaydırma girişiminde bulunulduğunda bu özel durumu atın. |