Aracılığıyla paylaş

ExpandCollapse Denetim Deseni

IExpandCollapseProvideruygulamak için özellikler, yöntemler ve olaylar hakkında bilgiler de dahil olmak üzere yönergeleri ve kuralları açıklar. ExpandCollapse denetim düzeni, daha fazla içerik görüntülemek için görsel olarak genişleten ve içeriği gizlemek için daraltan denetimleri desteklemek için kullanılır.

Bu denetim desenini uygulayan denetim örnekleri için bkz. Denetim Türleri ve Desteklenen Denetim Desenleri.

Bu konu aşağıdaki bölümleri içerir.

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 denetimleri, ExpandCollapse denetim desenini desteklemelidir, ancak 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 ExpandCollapse denetim desenini desteklemesi gereken üst birleşik giriş kutusudur.

    Not

    Özel durum, tek tek menü öğesi nesnelerinin bir toplamı olan menü denetimidir. Menü öğesi nesneleri ExpandCollapse denetim desenini destekleyebilir, ancak üst menü denetimi bunu yapamaz. Benzer bir özel durum ağaç ve ağaç öğesi denetimleri için de geçerlidir.

     

  • Bir denetimin IExpandCollapseProvider::ExpandCollapseStateExpandCollapseState_LeafNodeolarak ayarlandığında, ExpandCollapse işlevleri şu anda denetim için etkin değildir ve bu denetim deseni kullanılarak elde edilebilecek tek bilgi ExpandCollapseState. Daha sonra alt nesneler eklenirse ExpandCollapseState değişir ve ExpandCollapse işlevselliği 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.

  • IExpandCollapseProvider::Expand ve Daralt işlevselliği denetime özgüdür. Bu davranışa örnekler aşağıda verilmiştir.

    • Office Kişisel Menüsü, denetiminGenişlet veya Daraltçağrıldığında benimsenecek durumu belirttiği üç durumlu bir menü öğesi ("Genişletilmiş", "Daraltıldı" ve "Kısmen Genişletildi") olabilir.
    • Çağırma Ağaç öğesindeki genişlet seçeneği tüm alt öğeleri veya yalnızca anlık alt öğeleri görüntüleyebilir.
    • arama Genişlet veya Bir denetimdeki Daralt alt öğeleri 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; veya her alt öğe için ExpandCollapseStatedeğiştirebilir ve görünürlük değişikliği olayını tetikleyebilir.

  • Gezintiyi garanti etmek için, bir nesnenin Üst ExpandCollapseStatene olursa olsun Microsoft UI Otomasyonu ağacında (uygun görünürlük durumuyla) olması 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

IExpandCollapseProvider arabirimini uygulamak için aşağıdaki özellikler, yöntemler ve olaylar gereklidir.

Gerekli üyeler Üye türü Notlar
ExpandCollapseState Mülk Hiç kimse
Genişlet Yöntem Hiç kimse
Daralt Yöntem Hiç kimse
IUIAutomationPropertyChangedEventHandler Olay Bu denetimin ilişkili olayı yok; bu genel olay işleyicisini kullanın.

 

Denetim Türlerini ve Desteklenen Denetim Desenlerini

UI Otomasyonu Denetim Desenlerine Genel Bakış

UI Otomasyon Ağacına Genel Bakış

 

 

  • Last updated on