Aracılığıyla paylaş


ScrollBar Denetim Türü

Bu konu, ScrollBar denetim türü için Microsoft UI Otomasyonu desteği hakkında bilgi sağlar.

Kaydırma çubuğu denetimleri, kullanıcının bir pencere veya öğe kapsayıcısı içindeki içeriği kaydırmasına olanak tanır. Denetim, bir dizi düğmeden ve bir başparmak denetiminden oluşur.

Aşağıdaki bölümlerde, ScrollBar denetim türü için gerekli UI Otomasyonu ağaç yapısı, özellikleri, denetim desenleri ve olayları tanımlanmıştır. UI Otomasyonu gereksinimleri, UI çerçevesinin/platformunun denetim türleri ve denetim desenleri için UI Otomasyonu desteğini tümleştirdiği tüm kaydırma çubuğu denetimleri için geçerlidir.

Bu konu aşağıdaki bölümleri içerir.

Tipik Ağaç Yapısı

Aşağıdaki tabloda, ui Otomasyonu ağacının kaydırma çubuğu denetimleriyle ilgili tipik bir denetimi ve içerik görünümü gösterilir ve her görünümde nelerin içerilebileceğini açıklar. UI Otomasyonu ağacı hakkında daha fazla bilgi için bkz. UI Otomasyon Ağacına Genel Bakış.

Denetim Görünümü İçerik Görünümü
  • Kaydırma Çubuğu
    • Düğme (0, 2 veya 4)
    • Başparmak (0 veya 1)
Uygulanamaz. (Kaydırma çubuğu denetiminin içeriği yok.)

 

Kaydırma çubuğu denetiminin alt öğeleri sıfırdan beşe kadar olabilir. Alt ağaç birden fazla düğme denetimine sahip olduğundan, öğesinin otomatik test araçları için bulunabilir hale getirmek için her öğeye belirli bir UIA_AutomationIdPropertyId değeri ayarlaması gerekir.

İlgili Özellikler

Aşağıdaki tabloda, değeri veya tanımı özellikle kaydırma çubuğu denetimleriyle ilgili olan UI Otomasyonu özellikleri listeleniyor. Kaydırma çubuğu denetiminin hiçbir zaman içeriği olmadığını unutmayın; işlevselliği, kaydırılan kapsayıcıda desteklenen Kaydırma denetim deseni aracılığıyla kullanıma sunulur.

UI Otomasyonu özellikleri hakkında daha fazla bilgi için bkz. UI Automation Öğelerinden Özellikleri Alma.

UI Otomasyonu Özelliği Değer Notlar
UIA_AutomationIdPropertyId Notlara bakın. Bu özelliğin değeri, UI Otomasyonu ağacının ham görünümündeki tüm eş öğeler arasında benzersiz olmalıdır.
UIA_BoundingRectanglePropertyId Notlara bakın. Denetimin tamamını içeren en dıştaki dikdörtgen.
UIA_ClickablePointPropertyId Nan Kaydırma çubuğu denetiminin tıklanabilir noktaları yok.
UIA_ControlTypePropertyId ScrollBar Bu değer tüm çerçeveler için aynıdır. Kaydırıcı işlevi görecek kaydırma çubukları, Kaydırıcı denetim türünü kullanmalıdır.
UIA_IsContentElementPropertyId YANLIŞ Kaydırma çubuğu denetimi hiçbir zaman bir içerik öğesi değildir. Kaydırma çubuğu tek başına bir denetimse, Slider denetim türünü karşılamalı ve IUIAutomationElement::CurrentControlType (veya CachedControlType) özelliği içinUIA_SliderControlTypeId döndürmelidir.
UIA_IsControlElementPropertyId DOĞRU Kaydırma çubuğu denetimi her zaman UI Otomasyonu ağacının denetim görünümüne eklenir.
UIA_IsKeyboardFocusablePropertyId Notlara bakın. Denetim klavye odağını alabiliyorsa bu özelliği desteklemesi gerekir. Kaydırma çubuğu denetimi odağı nadiren alır, ancak aldığında odak alt düğmelerde veya başparmakta değil kaydırma çubuğu denetiminin kendisinde kalmalıdır. Kullanıcı, YUKARı OK ve AŞAĞI OK (veya SAĞ OK ve SOL OK) tuşlarını ya da PAGE UP ve PAGE DOWN tuşlarını kullanarak tüm kaydırma eylemlerini gerçekleştirebilmelidir.
UIA_LabeledByPropertyId SIFIR Kaydırma çubuklarının etiketi yoktur.
UIA_LocalizedControlTypePropertyId Notlara bakın. ScrollBar denetim türüne karşılık gelen yerelleştirilmiş dize. Varsayılan değer, en-US veya İngilizce (ABD) için "kaydırma çubuğu"dur.
UIA_NamePropertyId SIFIR Kaydırma çubuğu denetiminin içerik öğeleri yoktur ve UIA_NamePropertyId özelliğinin ayarlanması gerekmez.
UIA_OrientationPropertyId Notlara bakın. Kaydırma çubuğu denetimi her zaman yatay veya dikey yönlendirmesini ortaya çıkarmalıdır.

 

Gerekli Denetim Desenleri

Aşağıdaki tabloda, tüm kaydırma çubuğu denetimleri tarafından desteklenmesi için gereken UI Otomasyonu denetim desenleri listelenmektedir. Denetim desenleri hakkında daha fazla bilgi için bkz. UI Otomasyonu Denetim Desenlerine Genel Bakış.

Not

Kaydırma çubuğu yalnızca fare işleme için denetim olarak kullanıldığında, denetim desenlerini desteklemez. Bir uygulama içinde kaydırıcı denetimi olarak kullanılıyorsa, Slider denetim türü verilmelidir.

 

Denetim Deseni Destek Notlar
IRangeValueProvider -Sına bağ -lıdır RangeValue denetim deseninin yalnızca kaydırma çubuğuna sahip kapsayıcıda Kaydırma denetim deseni desteklenmediği durumlarda desteklenmesi gerekir.
IScrollProvider Hiç Kaydırma denetim düzeni kaydırma çubuğunda hiçbir zaman doğrudan desteklenmez.

 

Gerekli Olaylar

Aşağıdaki tabloda, desteklemek için kaydırma çubuğu denetimlerinin gerekli olduğu UI Otomasyonu olayları listelenir. Olaylar hakkında daha fazla bilgi için bkz. UI Otomasyonu Olaylarına Genel Bakış.

UI Otomasyonu Olayı Notlar
UIA_AutomationFocusChangedEventId
özelliği değiştirilmiş olayı UIA_BoundingRectanglePropertyId.
özelliği değiştirilmiş olayı UIA_IsEnabledPropertyId. Denetim IsEnabledözelliğini destekliyorsa bu olayı desteklemesi gerekir.
özelliği değiştirilmiş olayı UIA_IsOffscreenPropertyId. Denetim IsOffscreen özelliğini destekliyorsa, bu olayı desteklemesi gerekir.
UIA_StructureChangedEventId
özelliği değiştirilmiş olayı UIA_RangeValueValuePropertyId. Denetim, RangeValue denetim desenini destekliyorsa, bu olayı desteklemesi gerekir.

 

kavramsal

UI Otomasyonu Denetim Türlerine Genel Bakış

UI Otomasyonuna Genel Bakış