UI Otomasyon ExpandCollapse Denetim Düzeni Uygulama
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 konuda özellikler, yöntemler ve olaylar hakkında bilgiler de dahil olmak üzere uygulama IExpandCollapseProvideryönergeleri ve kuralları tanıtılmaktadır. Ek başvuruların bağlantıları genel bakışın sonunda listelenir.
Denetim ExpandCollapsePattern düzeni, daha fazla içerik görüntülemek için görsel olarak genişleyen ve içeriği gizlemek için daraltan denetimleri desteklemek için kullanılır. Bu denetim desenini uygulayan denetim örnekleri için bkz. UI Otomasyonu İstemcileri için Denetim Düzeni Eşlemesi.
Uygulama Yönergeleri ve Kuralları
ExpandCollapse denetim desenini uygularken aşağıdaki yönergelere ve kurallara dikkat edin:
Kullanıcı arabirimine genişletme/daraltma işlevselliği sağlayan alt nesnelerle oluşturulan toplama denetimlerinin denetim desenini ExpandCollapsePattern desteklemesi gerekirken, alt öğeleri desteklemez. Örneğin, birleşik giriş kutusu denetimi liste kutusu, düğme ve düzenleme denetimlerinin birleşimiyle oluşturulur, ancak yalnızca öğesini desteklemesi ExpandCollapsePatterngereken üst birleşik giriş kutusudur.
Not
Özel durum, tek tek MenuItem nesnelerinin bir toplamı olan menü denetimidir. MenuItem nesneleri denetim desenini ExpandCollapsePattern destekleyebilir, ancak üst Menü denetimi desteklemez. Benzer bir özel durum Ağaç ve Ağaç Öğesi denetimleri için de geçerlidir.
Denetimin ExpandCollapseState ayarı olarak ayarlandığında LeafNode, herhangi ExpandCollapsePattern bir işlev denetim için şu anda etkin değildir ve bu denetim deseni kullanılarak elde edilebilecek tek bilgi şudur ExpandCollapseState: . Daha sonra alt nesneler eklenirse, ExpandCollapseState değişiklikler ve ExpandCollapsePattern işlevler etkinleştirilir.
ExpandCollapseState yalnızca anlık alt nesnelerin görünürlüğünü ifade eder; tüm alt nesnelerin görünürlüğüne başvurmaz.
Genişletme ve Daralt işlevleri denetime özgüdür. Bu davranışa örnekler aşağıda verilmiştir.
Office Kişisel Menüsü, Collapsed denetimin veya Collapse çağrıldığında benimsenecek durumu belirttiği üç durumlu bir Expand MenuItem (Expandedve PartiallyExpanded) olabilir.
TreeItem'da çağırmak Expand tüm alt öğeleri veya yalnızca anlık alt öğeleri görüntüleyebilir.
Arama Expand veya Collapse denetimde alt öğelerinin durumunu koruyorsa, durum değişikliği olayı değil görünürlük değişikliği olayı gönderilmelidir Üst denetim daraltıldığında alt öğelerinin durumunu korumazsa, denetim artık görünür olmayan tüm alt öğeleri yok edebilir ve yok edilmiş bir olay tetikler; ya da her alt öğe için öğesini değiştirebilir ExpandCollapseState ve görünürlük değişikliği olayı tetikler.
Gezintiyi garanti etmek için, bir nesnenin üst ExpandCollapseStateöğelerinden bağımsız olarak UI Otomasyonu ağacında (uygun görünürlük durumuna sahip) olması istenir. Alt öğeler isteğe bağlı olarak oluşturulursa, yalnızca ilk kez görüntülendikten sonra veya yalnızca görünür durumdayken UI Otomasyonu ağacında görünebilirler.
IExpandCollapseProvider için Gerekli Üyeler
uygulamak IExpandCollapseProvideriçin aşağıdaki özellikler ve yöntemler gereklidir.
| Gerekli üyeler | Üye türü | Notlar |
|---|---|---|
| ExpandCollapseState | Özellik | Hiçbiri |
| Expand | Metot | Hiçbiri |
| Collapse | Metot | Hiçbiri |
| AutomationPropertyChangedEventHandler | Etkinlik | Bu denetimin ilişkili olayı yok; bu genel temsilciyi kullanın. |
Özel durumlar
Sağlayıcıların aşağıdaki özel durumları oluşturması gerekir.
| Özel durum türü | Koşul |
|---|---|
| InvalidOperationException | veya ExpandCollapse olduğunda çağrılır.ExpandCollapseState = LeafNode |