Aracılığıyla paylaş


Spinner Denetim Türü

Bu konu başlığında, Spinner denetim türü için Microsoft UI Automation desteği hakkında bilgi sağlanır.

Spinner denetimleri, bir öğe etki alanından veya sayı aralığından seçim yapmak için kullanılır.

Aşağıdaki bölümlerde, Spinner 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 değiştirici denetimleri için geçerlidir.

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

Tipik Ağaç Yapısı

Aşağıdaki tabloda, RangeValue ve Selection denetim desenlerini desteklediklerinde spinner denetimleriyle ilgili ui Otomasyonu ağacının 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ış.

RangeValue denetim deseni

Denetim Görünümü İçerik Görünümü
  • Spinner
    • Düzenle (0 veya 1)
    • Düğme (2)
  • Spinner

 

seçim denetimi deseni

Denetim Görünümü İçerik Görünümü
  • Spinner
    • Düzenle (0 veya 1)
    • Düğme (2)
    • Liste Öğesi (0 veya daha fazla)
  • Spinner
    • ListItem (0 veya daha fazla)

 

Denetim görünümü alt ağacındaki iki düğmenin otomatik test araçlarıyla ayırt edilebilmesini sağlamak için ScrollAmount_SmallIncrement veya ScrollAmount_SmallDecrement değerini AutomationId özelliğine uygun şekilde atayın. Bazı uygulamalar için ilişkili düzenleme denetimi, değiştirici denetiminin bir eş değeri olabilir.

İlgili Özellikler

Aşağıdaki tabloda, değeri veya tanımı özellikle değiştirici denetimleriyle ilgili olan UI Otomasyonu özellikleri listeleniyor. 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 Notlara bakın. Değiştirici denetiminin tıklanabilir noktası, odağı denetimin düzenleme bölümüne verir.
UIA_ControlTypePropertyId Spinner Bu değer tüm çerçeveler için aynıdır.
UIA_IsContentElementPropertyId DOĞRU Değiştirici denetimi her zaman içerik olmalıdır.
UIA_IsControlElementPropertyId DOĞRU Değiştirici denetimi her zaman bir denetim olmalıdır.
UIA_IsKeyboardFocusablePropertyId Notlara bakın. Denetim klavye odağını alabiliyorsa bu özelliği desteklemesi gerekir. Spinner denetimi nadiren odağı alır, ancak aldığında odak alt düğmelerde değil, değiştirici denetiminde kalmalıdır. Kullanıcı, YUKARI OK ve AŞAĞI OK tuşlarını kullanarak tüm kaydırma eylemlerini gerçekleştirebilmelidir.
UIA_LabeledByPropertyId Notlara bakın. Değiştirici denetimlerinin statik metin etiketi vardır.
UIA_LocalizedControlTypePropertyId Notlara bakın. Spinner denetim türüne karşılık gelen yerelleştirilmiş dize. Varsayılan değer, en-US veya İngilizce (ABD) için "spinner" değeridir.
UIA_NamePropertyId Notlara bakın. Değiştirici denetimi genellikle adını statik bir metin etiketinden alır.

 

Gerekli Denetim Desenleri

Aşağıdaki tabloda, tüm değiştirici 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ış.

Denetim Deseni/Desen Özelliği Destek/Değer Notlar
IRangeValueProvider -Sına bağ -lıdır Sayısal aralığa yayılan değiştirici denetimleri, RangeValue denetim desenini destekleyebilir.
ISelectionProvider -Sına bağ -lıdır Seçilecek öğelerin listesini içeren değiştirici denetimleri, Seçimi denetim desenini desteklemelidir.
CanSelectMultiple YANLIŞ Değiştirici denetimleri her zaman tek seçim kapsayıcılarıdır.
IValueProvider -Sına bağ -lıdır Bir dizi seçenek veya sayıya yayılan değiştirici denetimleri, Değer denetim desenini destekleyebilir.

 

Gerekli Olaylar

Aşağıdaki tabloda, spinner denetimlerinin desteklemesi gereken 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.
özelliği değiştirilmiş olayı UIA_RangeValueValuePropertyId. Denetim, RangeValue denetim desenini destekliyorsa, bu olayı desteklemesi gerekir.
özelliği değiştirilmiş olayı UIA_Selection_InvalidatedEventId. Denetim, Seçimi denetim desenini destekliyorsa, bu olayı desteklemesi gerekir.
UIA_StructureChangedEventId
UIA_ValueValuePropertyId özelliği değiştirilmiş olay. Denetim Değer denetim desenini destekliyorsa, bu olayı desteklemesi gerekir.

 

kavramsal

UI Otomasyonu Denetim Türlerine Genel Bakış

UI Otomasyonuna Genel Bakış