ProgressBar Denetim Türü için UI Otomasyon Desteği
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, ProgressBar denetim türü için UI Otomasyonu desteği hakkında bilgi sağlar. UI Otomasyonu denetim türü, bir denetimin özelliğini kullanabilmesi için karşılaması gereken bir koşul kümesidirControlTypeProperty. Koşullar arasında UI Otomasyonu ağaç yapısı, UI Otomasyonu özellik değerleri, denetim desenleri ve UI Otomasyonu olayları için belirli yönergeler bulunur.
İlerleme çubuğu denetimleri, ProgressBar denetim türünü uygulayan bir denetim örneğidir. İlerleme çubuğu denetimleri, uzun bir işlemin ilerleme durumunu göstermek için kullanılır. Denetim, işlem ilerledikçe sistem vurgu rengiyle aşamalı olarak doldurulan bir dikdörtgenden oluşur.
Aşağıdaki bölümler ProgressBar denetim türü için gerekli UI Otomasyonu ağaç yapısını, özelliklerini, denetim desenlerini ve olaylarını tanımlar. UI Otomasyonu gereksinimleri, Windows Presentation Foundation (WPF), Win32 veya Windows Forms olsun tüm liste denetimleri için geçerlidir.
Gerekli UI Otomasyonu Ağaç Yapısı
Aşağıdaki tabloda, ilerleme çubuğu denetimleriyle ilgili UI Otomasyonu ağacının denetim görünümü ve içerik görünümü gösterilir ve her görünümde nelerin içerilebileceği açıklanır. UI Otomasyonu ağacı hakkında daha fazla bilgi için bkz. UI Otomasyonu Ağacına Genel Bakış.
| Denetim Görünümü | İçerik Görünümü |
|---|---|
| ProgressBar | ProgressBar |
İlerleme çubuğu denetimlerinde, UI Otomasyonu ağacının denetiminde veya içerik görünümünde alt öğe yoktur.
Gerekli UI Otomasyonu Özellikleri
Aşağıdaki tabloda, değeri veya tanımı özellikle ilerleme çubuğu denetimleriyle ilgili olan UI Otomasyonu özellikleri listeleniyor. UI Otomasyonu özellikleri hakkında daha fazla bilgi için bkz. İstemciler için Özellikler UI Otomasyonu.
| UI Otomasyonu Özelliği | Değer | Notlar |
|---|---|---|
| AutomationIdProperty | Notlara bakın. | Bu özelliğin değerinin bir uygulamadaki tüm denetimlerde benzersiz olması gerekir. |
| BoundingRectangleProperty | Notlara bakın. | Denetimin tamamını içeren en dıştaki dikdörtgen. |
| ClickablePointProperty | 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 özel isabet testi gerçekleştiriyorsanız, geçersiz kılın ve tıklanabilir bir nokta sağlayın. |
| IsKeyboardFocusableProperty | Notlara bakın. | Denetim klavye odağını alabiliyorsa bu özelliği desteklemesi gerekir. |
| NameProperty | Notlara bakın. | İlerleme çubuğu denetimi genellikle adını statik bir metin etiketinden alır. Statik metin etiketi yoksa uygulama geliştiricisinin özelliği için bir değer kullanıma sunması Name gerekir. |
| LabeledByProperty | Notlara bakın. | Statik bir metin etiketi varsa, bu özelliğin bu denetime bir başvuru kullanıma sunması gerekir. |
| ControlTypeProperty | ProgressBar | Bu değer tüm ui çerçeveleri için aynıdır. |
| LocalizedControlTypeProperty | "ilerleme çubuğu" | ProgressBar denetim türüne karşılık gelen yerelleştirilmiş dize. |
| IsContentElementProperty | True | İlerleme çubuğu denetimi her zaman UI Otomasyonu ağacının içerik görünümüne eklenir. |
| IsControlElementProperty | True | İlerleme çubuğu denetimi her zaman UI Otomasyonu ağacının denetim görünümüne eklenir. |
Gerekli UI Otomasyonu Denetim Desenleri ve Özellikleri
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 |
|---|---|---|
| IValueProvider | -Sına bağ -lıdır | İlerleme durumunun metinsel göstergesini veren ilerleme çubuğu denetimlerinin uygulaması IValueProvidergerekir. |
| IsReadOnly | True | Bu özelliğin değeri her zaman True'dur. |
| Value | Notlara bakın. | Bu özellik, ilerleme çubuğu denetiminin metinsel ilerleme durumunu kullanıma sunar. |
| IRangeValueProvider | -Sına bağ -lıdır | Sayısal aralığın uygulanması gereken ilerleme çubuğu denetimleri IRangeValueProvider |
| Minimum | 0,0 | Bu özelliğin değeri, denetimin ayarlanabileceği en küçük değerdir. |
| Maximum | 100.0 | Bu özelliğin değeri, denetimin ayarlanabileceği en büyük değerdir. |
| 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. |
Gerekli UI Otomasyonu Olayları
Aşağıdaki tabloda, tüm ilerleme çubuğu denetimleri tarafından desteklenmesi gereken UI Otomasyonu olayları listelenmektedir. Olaylar hakkında daha fazla bilgi için bkz. UI Otomasyonu Olaylara Genel Bakış.
| UI Otomasyonu Olayı | Destek | Notlar |
|---|---|---|
| BoundingRectangleProperty property-changed olayı. | Zorunlu | Hiçbiri |
| IsOffscreenProperty property-changed olayı. | Zorunlu | Hiçbiri |
| IsEnabledProperty property-changed olayı. | Zorunlu | Hiçbiri |
| NameProperty property-changed olayı. | Zorunlu | Hiçbiri |
| ValueProperty property-changed olayı. | -Sına bağ -lıdır | Hiçbiri |
| AutomationFocusChangedEvent | Zorunlu | Hiçbiri |
| StructureChangedEvent | Zorunlu | Hiçbiri |