Ağaç Denetim Türü İç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, Ağaç 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 UI Otomasyonu ağaç yapısı, UI Otomasyonu özellik değerleri ve denetim desenleri için belirli yönergeleri içerir.
Ağaç denetim türü, microsoft Windows Gezgini'nin sol bölmesinde dosya ve klasörlerin görüntülenme şekli gibi, içeriği düğüm hiyerarşisi olarak ilgi düzeyine sahip kapsayıcılar için kullanılır. Her düğümün alt düğümler olarak adlandırılan diğer düğümleri içerme olasılığı vardır. Üst düğümler veya alt düğümler içeren düğümler genişletilmiş veya daraltılmış olarak görüntülenebilir.
Aşağıdaki bölümlerde Ağaç denetim türü için gerekli UI Otomasyonu ağaç yapısı, özellikleri, denetim desenleri ve olayları tanımlanmıştır. UI Otomasyonu gereksinimleri, Windows Presentation Foundation (WPF), Win32 veya Windows Forms olsun tüm ağaç denetimleri için geçerlidir.
Gerekli UI Otomasyonu Ağaç Yapısı
Aşağıdaki tabloda, ağaç 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ü |
|---|---|
Ağaç
|
Ağaç
|
UI Otomasyonu ağacının denetim görünümü şunlardan oluşur:
Kapsayıcı içindeki sıfırdan çok öğeye (öğeler Ağaç Öğesi, Veri Öğesi veya başka bir denetim türüne göre olabilir).
Sıfır, bir veya iki kaydırma çubuğu.
UI Otomasyonu ağacının içerik görünümü, kapsayıcı içindeki sıfır veya çok sayıda öğeden oluşur (öğeler Ağaç Öğesi, Veri Öğesi veya başka bir denetim türüne göre olabilir).
Gerekli UI Otomasyonu Özellikleri
Aşağıdaki tabloda, değeri veya tanımı özellikle liste 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. | Ağaç denetimlerinin tıklanabilir bir noktası vardır ve bu da ağacın veya ağaç kapsayıcısı içindeki öğelerden birinin odağın üzerinde olmasına neden olur. Ağaç için tıklanabilir bir nokta elde etmek için öğelerden birinin seçilmesine/odaklanmasına neden olmayan bir yere tıklayabilirsiniz. |
| ControlTypeProperty | Ağaç | Bu değer tüm ui çerçeveleri için aynıdır. |
| IsContentElementProperty | True | Ağaç denetimi her zaman UI Otomasyonu ağacının içerik görünümüne dahil edilir. |
| IsControlElementProperty | True | Ağaç denetimi her zaman UI Otomasyonu ağacının denetim görünümüne dahil edilir. |
| IsKeyboardFocusableProperty | Notlara bakın. | Denetim klavye odağını alabiliyorsa bu özelliği desteklemesi gerekir. |
| LabeledByProperty | Notlara bakın. | Ağaç denetiminin kendisiyle ilişkilendirilmiş bir etiketi varsa, bu özellik bu etiket için bir AutomationElement döndürür. Aksi takdirde, özelliği null başvuru döndürür (Nothing Microsoft Visual Basic .NET'te). |
| LocalizedControlTypeProperty | "ağaç" | Liste denetim türüne karşılık gelen yerelleştirilmiş dize. |
| NameProperty | Notlara bakın. | Ağaç denetiminin ad özelliğinin değeri genellikle denetimi etiketleyen metinden gelir. Metin etiketi yoksa uygulama geliştiricisinin bu özellik için bir değer sağlaması gerekir. |
Gerekli UI Otomasyonu Denetim Desenleri
Aşağıdaki tabloda, liste 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 |
|---|---|---|
| ISelectionProvider | -Sına bağ -lıdır | Seçilebilir öğeler kümesi içeren ağaç denetimleri bu denetim desenini uygulamalıdır. Bir öğe seçildiğinde kullanıcıya anlamlı bilgiler aktarılmıyorsa bu denetim düzeninin uygulanması gerekmez. |
| CanSelectMultiple | Notlara bakın. | Ağaç denetimi birden çok seçimi destekliyorsa (çoğu ağaç denetimi birden çok seçimi desteklemez) bu özelliği uygulayın. |
| IsSelectionRequired | Notlara bakın. | Bu özelliğin değeri, denetim bir öğenin seçilmesini gerektiriyorsa kullanıma sunulur. |
| IScrollProvider | -Sına bağ -lıdır | Ağaç kapsayıcısının içeriği kaydırılabilirse bu denetim desenini uygulayın. |
Gerekli UI Otomasyonu Olayları
Aşağıdaki tabloda tüm ağaç 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 |
|---|---|---|
| InvalidatedEvent | -Sına bağ -lıdır | Hiçbiri |
| BoundingRectangleProperty property-changed olayı. | Zorunlu | Hiçbiri |
| IsOffscreenProperty property-changed olayı. | Zorunlu | Hiçbiri |
| IsEnabledProperty property-changed olayı. | Zorunlu | Hiçbiri |
| HorizontallyScrollableProperty property-changed olayı. | -Sına bağ -lıdır | Hiçbiri |
| HorizontalScrollPercentProperty property-changed olayı. | -Sına bağ -lıdır | Hiçbiri |
| HorizontalViewSizeProperty property-changed olayı. | -Sına bağ -lıdır | Hiçbiri |
| VerticalScrollPercentProperty property-changed olayı. | -Sına bağ -lıdır | Hiçbiri |
| VerticallyScrollableProperty property-changed olayı. | -Sına bağ -lıdır | Hiçbiri |
| VerticalViewSizeProperty property-changed olayı. | -Sına bağ -lıdır | Hiçbiri |
| AutomationFocusChangedEvent | Zorunlu | Hiçbiri |
| StructureChangedEvent | Zorunlu | Hiçbiri |