Aracılığıyla paylaş


ProgressBar Denetim Türü

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

İlerleme çubuğu denetimleri, uzun bir işlemin ilerleme durumunu gösterir. Denetim, işlem ilerledikçe sistem vurgu rengiyle aşamalı olarak doldurulan bir dikdörtgenden oluşur.

Aşağıdaki bölümlerde, ProgressBar 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 ilerleme ç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, ilerleme çubuğu 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ış.

Denetim Görünümü İçerik Görünümü
  • İlerleme Çubuğu
  • İlerleme Çubuğu

İlerleme çubuğu denetimlerinin UI Otomasyon ağacının denetiminde veya içerik görünümünde alt öğe yoktur.

İlgili Özellikler

Aşağıdaki tabloda, değeri veya tanımı özellikle ilerleme çubuklarıyla 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. Sınırlayıcı bir dikdörtgen varsa desteklenir. Sınırlayıcı dikdörtgenin içindeki her nokta tıklanabilir değilse ve öğesi özel isabet testi gerçekleştiriyorsa, geçersiz kılın ve tıklanabilir bir nokta sağlayın.
UIA_ControlTypePropertyId ProgressBar
UIA_IsContentElementPropertyId true İlerleme çubuğu denetimi her zaman UI Otomasyonu ağacının içerik görünümüne eklenir.
UIA_IsControlElementPropertyId true İlerleme ç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.
UIA_LabeledByPropertyId Notlara bakın. Statik bir metin etiketi varsa, bu özelliğin bu denetime bir başvuru kullanıma sunması gerekir.
UIA_LocalizedControlTypePropertyId Notlara bakın. ProgressBar denetim türüne karşılık gelen yerelleştirilmiş dize. Varsayılan değer, en-US veya İngilizce (ABD) için "ilerleme çubuğu"dur.
UIA_NamePropertyId Notlara bakın. İlerleme çubuğu denetimi genellikle adını statik bir metin etiketinden alır. Statik metin etiketi yoksa uygulama geliştiricisinin Name özelliği için bir değer kullanıma sunması gerekir.

 

Gerekli Denetim Desenleri

Aşağıdaki tabloda, ilerleme ç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ış.

Denetim Deseni/Desen Özelliği Destek/Değer Notlar
IRangeValueProvider -Sına bağ -lıdır Sayısal aralık alan ilerleme çubuğu denetimleri, RangeValue denetim desenini uygulamalıdır.
Minimum -Sına bağ -lıdır Bu özelliğin değeri, denetimin ayarlanabileceği en düşük değerdir. Bu değer En Fazladeğerinden küçük olmalıdır.
En Fazla -Sına bağ -lıdır Bu özelliğin değeri, denetimin ayarlanabileceği en yüksek değerdir. Bu değer Minimumdeğerinden büyük olmalıdır.
SmallChange NaN İlerleme çubuğu denetimleri salt okunur olduğundan bu özellik gerekli değildir.
LargeChange NaN İlerleme çubuğu denetimleri salt okunur olduğundan bu özellik gerekli değildir.
IValueProvider -Sına bağ -lıdır İlerlemenin metinsel göstergesini veren ilerleme çubuğu denetimleri, Değer denetim desenini uygulamalıdır.
IsReadOnly true Bu özelliğin değeri her zaman TRUE .
Değer Notlara bakın. Bu özellik, ilerleme çubuğu denetiminin metinsel ilerleme durumunu kullanıma sunar.

 

Gerekli Olaylar

Aşağıdaki tabloda, ilerleme çubuklarının 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_NamePropertyId.
UIA_StructureChangedEventId
özelliği değiştirilmiş olayı UIA_RangeValueValuePropertyId. Denetim, RangeValue denetim desenini destekliyorsa, bu olayı desteklemesi gerekir.
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ış