Aracılığıyla paylaş

UI Otomasyonu GenişletDaralt Denetim Desenini Uygulama

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 başlığında özellikler, yöntemler ve olaylar hakkında bilgiler de dahil olmak üzere IExpandCollapseProvideruygulamaya yönelik yönergeler ve kurallar tanıtılmaktadır. Ek kaynakları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 Automation İstemcileri için Denetim Deseni Eşlemesi.

Uygulama Yönergeleri ve Kuralları

ExpandCollapse denetim desenini uygularken aşağıdaki yönergelere ve kurallara dikkat edin:

  • Kullanıcı arayüzüne genişletme ve daraltma işlevi sağlayan alt nesnelerle oluşturulan toplama denetimlerinin kontrol desenini ExpandCollapsePattern desteklemesi gerekirken, alt öğeleri bunu desteklemez. Örneğin, kombo kutu denetimi, liste kutusu, düğme ve düzenleyici denetimlerin birleşimiyle oluşturulur, ancak yalnızca ExpandCollapsePattern öğesini desteklemesi gereken ana kombo kutusudur.

    Uyarı

    Ö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.

  • Bir denetimin ExpandCollapseState ayarı LeafNode olarak ayarlandığında, ExpandCollapsePattern işlevi kontrol için şu anda devre dışıdır ve bu kontrol modeli kullanılarak elde edilebilecek tek bilgi ExpandCollapseState'dir. Daha sonra alt nesneler eklenirse, ExpandCollapseState değişir ve ExpandCollapsePattern işlevselliği etkinleştirilir.

  • ExpandCollapseState yalnızca doğrudan alt nesnelerin görünürlüğünü ifade eder; tüm alt nesnelerin görünürlüğünü ifade etmez.

  • Genişletme ve Daralt işlevleri denetime özgüdür. Bu davranışa örnekler aşağıda verilmiştir.

    • Office Kişisel Menüsü, Expanded, Collapsed ve PartiallyExpanded olduğunda, Expand veya Collapse çağrıldığında benimsenecek durumu belirten üç durumlu bir MenuItem olabilir.

    • TreeItem'da Expand'i çağırmak, tüm alt öğeleri veya yalnızca doğrudan alt öğeleri görüntüleyebilir.

    • Bir denetimde Expand veya Collapse çağrıldığında, alt öğelerinin durumunu koruyorsa, durum değişikliği olayı değil, görünürlük değişikliği olayı gönderilmelidir. Eğer üst denetim daraltıldığında alt öğelerinin durumunu korumuyorsa, denetim artık görünür olmayan tüm alt öğeleri yok edebilir ve yok edilmiş bir olayı tetikleyebilir; veya her alt öğe için ExpandCollapseState değerini değiştirebilir ve görünürlük değişikliği olayı tetikleyebilir.

  • Gezinmeyi sağlamak amacıyla, bir nesnenin ebeveynlerinden bağımsız olarak uygun görünürlük durumuyla UI otomasyonu ağacında yer alması istenir. İsteğe bağlı olarak alt öğeler oluşturulursa, yalnızca ilk kez görüntülendikten sonra veya yalnızca görünür olduklarında 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 Mülkiyet Hiç kimse
Expand Yöntem Hiç kimse
Collapse Yöntem Hiç kimse
AutomationPropertyChangedEventHandler Etkinlik Bu kontrolün hiçbir ilişkili olayı yok; genel delegeyi kullanın.

Özel durumlar

Sağlayıcılar, aşağıdaki özel durumları fırlatmalıdır.

Özel durum türü Koşul
InvalidOperationException Ya Expand ya da Collapse, ExpandCollapseState = LeafNode olduğunda çağrılır.

Ayrıca bakınız

  • Last updated on