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.
Bu konu, TreeItem denetim türü için Microsoft UI Otomasyonu desteği hakkında bilgi sağlar.
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, UI çerçevesinin/platformunun denetim türleri ve denetim desenleri için UI Otomasyonu desteğini tümleştirdiği tüm ağaç öğesi denetimleri için geçerlidir.
Bu konu aşağıdaki bölümleri içerir.
- Tipik Ağaç Yapısı
- İlgili Özellikler
- Gerekli Denetim Desenlerini
- Gerekli Olayları
- Açıklamalar
- İlgili konular
Tipik Ağaç Yapısı
Aşağıdaki tabloda, ağaç öğesi 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ü |
|---|---|
|
|
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 DataItem denetim türünü temel almalıdır.
Daraltılmış ağaç öğeleri genişletilene ve görünene (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ünmez.
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 IUIAutomationElement::CurrentIsOffscreen (veya CachedIsOffscreen) özelliği TRUE olarak ayarlanmalıdır.
İlgili Özellikler
Aşağıdaki tabloda, değeri veya tanımı özellikle TreeItem denetim türüyle 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. | Bu özellik, ağaç öğesinin seçim durumunu değiştirmesine veya odaklanmış olmasına neden olan bir konum döndürmelidir. |
| UIA_ControlTypePropertyId | TreeItem | Bu değer tüm ui çerçeveleri için aynıdır. |
| UIA_IsContentElementPropertyId | true | Ağaç öğesi denetimi her zaman UI Otomasyonu ağacının içerik görünümüne dahil edilir. |
| UIA_IsControlElementPropertyId | true | Ağaç öğesi 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_IsOffscreenPropertyId | Notlara bakın. | Bu özellik, bir ağaç öğesi denetiminin ekrandan kaydırılıp kaydırılmadığını gösterir. |
| UIA_ItemStatusPropertyId | Notlara bakın. | Denetim dinamik olarak güncelleştirilen bir durum içeriyorsa, yardımcı bir teknolojinin öğenin durumu değiştiğinde güncelleştirmeleri alabilmesi için bu özelliğin desteklenmesi gerekir. |
| UIA_ItemTypePropertyId | Notlara bakın. | Ağaç öğesi denetimi belirli bir öğe türü olduğunu belirtmek için görsel bir simge kullanıyorsa, bu özelliğin desteklenmesi ve öğe türünü belirtmesi gerekir. |
| UIA_LabeledByPropertyId | NULL | Ağaç öğesi denetimleri kendi kendine etiketlenir. |
| UIA_LocalizedControlTypePropertyId | Notlara bakın. | TreeItem denetim türüne karşılık gelen yerelleştirilmiş dize. Varsayılan değer, en-US veya İngilizce (ABD) için "ağaç öğesi"dir. |
| UIA_NamePropertyId | Notlara bakın. | Bu özellik, her ağaç öğesi denetimi için görüntülenen metni kullanıma sunar. |
Gerekli Denetim Desenleri
Aşağıdaki tabloda, tüm ağaç öğesi 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 |
|---|---|---|
| IExpandCollapseProvider | Gerekli | Tüm öğeler genişletilebileceği veya daraltılabildiği için tüm ağaç öğelerinin ExpandCollapse denetim desenini desteklemesi gerekir. |
| ExpandCollapseState | Genişletilmiş, Daraltılmış veya Yaprak Düğüm | Ağaç öğeleri genişletilmediğinde veya daraltılmadığında yaprak düğümlerdir. |
| IInvokeProvider | -Sına bağ -lıdır | Ağaç öğesi bir komut gerçekleştirebiliyorsa Invoke denetim desenini uygulayın. |
| IScrollItemProvider | -Sına bağ -lıdır | Ağaç kapsayıcısı Scroll denetim desenini destekliyorsa ScrollItem 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 SelectionItem denetim desenini uygulayın. |
| SelectionContainer | Gerekli | Bu özellik, kapsayıcı içindeki tüm öğeler için aynı kapsayıcıyı kullanıma sunar. |
Gerekli Olaylar
Aşağıdaki tabloda, ağaç öğesi denetimlerinin 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. | |
| UIA_ExpandCollapseExpandCollapseStatePropertyId özelliği değiştirilmiş olay. | |
| UIA_Invoke_InvokedEventId | Denetim Invoke denetim desenini destekliyorsa, bu olayı desteklemesi gerekir. |
| ö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. |
| UIA_ItemStatusPropertyId özelliği değiştirilmiş olay. | Denetim ItemStatus özelliğini destekliyorsa bu olayı desteklemesi gerekir. |
| UIA_MultipleViewCurrentViewPropertyId özelliği değiştirilmiş olay. | Denetim, MultipleView denetim desenini destekliyorsa, bu olayı desteklemesi gerekir. |
| özelliği değiştirilmiş olayı UIA_NamePropertyId. | |
| UIA_SelectionItem_ElementAddedToSelectionEventId | Denetim SelectionItem denetim desenini destekliyorsa, bu olayı desteklemesi gerekir. |
| UIA_SelectionItem_ElementRemovedFromSelectionEventId | Denetim SelectionItem denetim desenini destekliyorsa, bu olayı desteklemesi gerekir. |
| UIA_SelectionItem_ElementSelectedEventId | Denetim SelectionItem denetim desenini destekliyorsa, bu olayı desteklemesi gerekir. |
| UIA_StructureChangedEventId | |
| özelliği değiştirilmiş olayı UIA_ToggleToggleStatePropertyId. | Denetim Geçiş 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. |
Açıklamalar
Bir ağaç öğesinin alt ana hat düğümleri dışında alt öğeleri varsa, sağlayıcının alt nesne bilgilerini dikkatli ve net bir şekilde işlemesi gerekir. UI Otomasyonu'nda ağaç yapısı, ağaç hiyerarşisi tarafından işlenir. Ana hat düğümü olmayan bir veya daha fazla alt öğeye sahip olmak, bunlar ile gerçek alt ana hat düğümleri arasındaki farklar ciddi şekilde belirsiz hale gelir.
İlgili konular