TreeItem 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, TreeItem 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.
TreeItem denetim türü, ağaç kapsayıcısı içindeki bir düğümü temsil eder. Her düğüm alt düğüm olarak adlandırılan başka düğümler içerebilir. Ü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 TreeItem 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ç öğesi denetimleri için geçerlidir.
Gerekli UI Otomasyonu Ağaç Yapısı
Aşağıdaki tabloda, ağaç öğesi 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ü |
|---|---|
| Treeıtem - Onay Kutusu (0 veya 1) - Görüntü (0 veya 1) - Düğme (0 veya 1) - TreeItem (0 veya daha fazla) |
Treeıtem - TreeItem (0 veya daha fazla) |
Ağaç öğesi denetimleri, UI Otomasyonu ağacının içerik görünümünde sıfır veya daha fazla ağaç öğesi alt öğesi içerebilir. Ağaç öğesi denetiminin aşağıda listelenen denetim desenlerinde gösterilenden daha fazla işlevi varsa, denetim Veri Öğesi denetim türünü temel almalıdır.
Daraltılmış ağaç öğeleri genişletilene ve görünene kadar (veya görünüme kaydırılabilir) denetim görünümünde veya içerik görünümünde görüntülenmez.
Denetim görünümü, ilişkili görüntü veya düğme de dahil olmak üzere bir denetim için ek ayrıntılar içerebilir. Örneğin, ana hat görünümündeki bir öğe, bir resmin yanı sıra ana hattı genişletme veya daraltma düğmesi içerebilir. Bilgiler zaten üst ağaç öğesi tarafından temsil edildiğinden, bu ayrıntı nesneleri içerik görünümünde görünmez. Ekrandan kaydırılan ağaç öğeleri, UI Otomasyonu ağacının hem denetim hem de içerik görünümlerinde görünür ve true olarak ayarlanmış olmalıdırIsOffscreenProperty.
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. | Bu özellik, öğenin seçim durumunu değiştirmesine veya odaklanmasına neden olacak bir konum döndürmelidir. |
| ControlTypeProperty | Treeıtem | Bu değer tüm ui çerçeveleri için aynıdır. |
| IsContentElementProperty | True | Liste denetimi her zaman UI Otomasyonu ağacının içerik görünümüne eklenir. |
| IsControlElementProperty | True | Liste denetimi her zaman UI Otomasyonu ağacının denetim görünümüne eklenir. |
| IsOffscreenProperty | Notlara bakın. | Bu özellik, bir ağaç öğesi denetiminin ekrandan ne zaman kaydırıldığında belirtecek şekilde ayarlanır. |
| IsKeyboardFocusableProperty | Notlara bakın. | Denetim klavye odağını alabiliyorsa bu özelliği desteklemesi gerekir. |
| ItemTypeProperty | Notlara bakın. | Ağaç öğesi denetimi belirli bir nesne türü olduğunu belirtmek için görsel bir simge kullanıyorsa, bu özelliğin desteklenmesi ve nesnenin ne olduğunu belirtmesi gerekir. |
| LabeledByProperty | Null |
Ağaç öğesi denetimleri kendi kendine etiketlenir. |
| LocalizedControlTypeProperty | "ağaç öğesi" | TreeItem denetim türüne karşılık gelen yerelleştirilmiş dize. |
| NameProperty | Notlara bakın. | Bu özellik, her ağaç öğesi denetimi için görüntülenen metni kullanıma sunar. |
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 |
|---|---|---|
| IInvokeProvider | -Sına bağ -lıdır | Ağaç öğesinin ayrı, eyleme dönüştürülebilir bir komutu varsa bu denetim desenini uygulayın. |
| IExpandCollapseProvider | Yes | Tüm ağaç öğeleri genişletilebilir veya daraltılabilir. |
| ExpandCollapseState | Genişletilmiş, Daraltılmış veya Yaprak Düğüm | Ağaç öğeleri genişletilmediğinde veya daraltılmadığında yaprak düğümler olur. |
| IScrollItemProvider | -Sına bağ -lıdır | Ağaç kapsayıcısı Kaydırma denetim desenini destekliyorsa bu denetim desenini uygulayın. |
| ISelectionItemProvider | -Sına bağ -lıdır | Kullanıcı ağaç kapsayıcısına döndüğünde korunan etkin bir seçime sahip olmak mümkünse bu denetim desenini uygulayın. |
| SelectionContainer | Yes | Bu özellik, kapsayıcı içindeki tüm öğeler için aynı kapsayıcıyı kullanıma sunar. |
| IToggleProvider | -Sına bağ -lıdır | Ağaç öğesinin ilişkili bir onay kutusu varsa bu denetim desenini uygulayın. |
Gerekli UI Otomasyonu Olayları
Aşağıdaki tabloda, tüm ağaç öğesi 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 |
|---|---|---|
| AutomationFocusChangedEvent | Zorunlu | Hiçbiri |
| BoundingRectangleProperty property-changed olayı. | Zorunlu | Hiçbiri |
| IsEnabledProperty property-changed olayı. | Zorunlu | Hiçbiri |
| IsOffscreenProperty property-changed olayı. | Zorunlu | Hiçbiri |
| ItemStatusProperty property-changed olayı. | -Sına bağ -lıdır | Hiçbiri |
| NameProperty property-changed olayı. | Zorunlu | Hiçbiri |
| StructureChangedEvent | Zorunlu | Hiçbiri |
| ExpandCollapseStateProperty property-changed olayı. | Zorunlu | Hiçbiri |
| InvokedEvent | -Sına bağ -lıdır | Hiçbiri |
| CurrentViewProperty property-changed olayı. | -Sına bağ -lıdır | Hiçbiri |
| ElementAddedToSelectionEvent | -Sına bağ -lıdır | Hiçbiri |
| ElementRemovedFromSelectionEvent | -Sına bağ -lıdır | Hiçbiri |
| ElementSelectedEvent | -Sına bağ -lıdır | Hiçbiri |
| ToggleStateProperty property-changed olayı. | -Sına bağ -lıdır | Hiçbiri |
| ValueProperty property-changed olayı. | -Sına bağ -lıdır | Hiçbiri |