Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
Uyarı
Bu belgeler, System.Windows.Automation ad alanında tanımlanan yönetilen UI Otomasyonu sınıflarını kullanmak isteyen .NET Framework geliştiricilerine 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'nda denetim türü, bir denetimin özelliğini kullanabilmesi için karşılaması gereken bir koşul kümesidir ControlTypeProperty . 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 Otomasyon 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 Otomasyon Ağacına Genel Bakış.
| Denetim Görünümü | İçerik Görünümü |
|---|---|
| TreeItem - Onay Kutusu (0 veya 1) - Görüntü (0 veya 1) - Düğme (0 veya 1) - TreeItem (0 veya daha fazla) |
TreeItem - 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şletilip görünür hale gelene kadar (veya görünüme kaydırılana kadar) 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 ayarlanmalıdır IsOffscreenProperty .
Gerekli UI Otomasyonu Özellikleri
Aşağıdaki tabloda, değeri veya tanımı liste denetimleriyle özellikle ilgili olan UI Otomasyonu özellikleri listeleniyor. UI Otomasyonu özellikleri hakkında daha fazla bilgi için bkz. İstemciler için UI Otomasyonu Özellikleri.
| 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 | TreeItem | Bu değer tüm ui çerçeveleri için aynıdır. |
| IsContentElementProperty | Doğru | Liste denetimi her zaman UI Otomasyonu ağacının içerik görünümüne eklenir. |
| IsControlElementProperty | Doğru | 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 Kullanıcı Arayüzü Otomasyonu Kontrol 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 | Duruma bağlı. | Ağaç öğesinin ayrı, eyleme dönüştürülebilir bir komutu varsa bu denetim desenini uygulayın. |
| IExpandCollapseProvider | Evet | 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 | Duruma bağlı. | Ağaç kapsayıcısı Kaydırma denetim desenini destekliyorsa, bu denetim desenini uygulayın. |
| ISelectionItemProvider | Duruma bağlı. | Kullanıcının ağaç kapsayıcısına döndüğünde devam eden etkin bir seçimi olması mümkünse, bu denetim desenini uygulayın. |
| SelectionContainer | Evet | Bu özellik, kapsayıcı içindeki tüm öğeler için aynı kapsayıcıyı kullanıma sunar. |
| IToggleProvider | Duruma bağlı. | Ağaç öğesinin ilişkili bir onay kutusu varsa bu kontrol desenini uygulayın. |
Gerekli UI Otomasyonu Olayları
Aşağıdaki tabloda, tüm ağaç öğesi denetimleri tarafından desteklenmesi için gereken UI Otomasyonu olayları listelenmektedir. Olaylar hakkında daha fazla bilgi için bkz. UI Otomasyonu Olaylarına Genel Bakış.
| UI Otomasyonu Olayı | Destek | Notlar |
|---|---|---|
| AutomationFocusChangedEvent | Gerekli | Hiç kimse |
| BoundingRectangleProperty özellik değişikliği olayı. | Gerekli | Hiç kimse |
| IsEnabledProperty özellik değişikliği olayı. | Gerekli | Hiç kimse |
| IsOffscreenProperty özellik değişikliği olayı. | Gerekli | Hiç kimse |
| ItemStatusProperty özellik değişikliği olayı. | Duruma bağlı. | Hiç kimse |
| NameProperty özellik değişikliği olayı. | Gerekli | Hiç kimse |
| StructureChangedEvent | Gerekli | Hiç kimse |
| ExpandCollapseStateProperty özellik değişikliği olayı. | Gerekli | Hiç kimse |
| InvokedEvent | Duruma bağlı. | Hiç kimse |
| CurrentViewProperty özellik değişikliği olayı. | Duruma bağlı. | Hiç kimse |
| ElementAddedToSelectionEvent | Duruma bağlı. | Hiç kimse |
| ElementRemovedFromSelectionEvent | Duruma bağlı. | Hiç kimse |
| ElementSelectedEvent | Duruma bağlı. | Hiç kimse |
| ToggleStateProperty özellik değişikliği olayı. | Duruma bağlı. | Hiç kimse |
| ValueProperty özellik değişikliği olayı. | Duruma bağlı. | Hiç kimse |