UI Otomasyon SelectionItem 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 ISelectionItemProvideryönergeleri ve kuralları tanıtılmaktadır. Ek başvuruların bağlantıları genel bakışın sonunda listelenir.
Denetim SelectionItemPattern düzeni, uygulayan ISelectionProviderkapsayıcı denetimlerinin tek tek, seçilebilir alt öğeleri gibi davranan denetimleri desteklemek için kullanılır. SelectionItem denetim desenini uygulayan denetim örnekleri için bkz. UI Otomasyonu İstemcileri için Denetim Deseni Eşlemesi
Uygulama Yönergeleri ve Kuralları
Seçim Öğesi denetim desenini uygularken aşağıdaki yönergelere ve kurallara dikkat edin:
- Uygulayan IRawElementProviderFragmentRootalt denetimleri yöneten tek seçimli denetimler, örneğin Görüntü Özellikleri iletişim kutusundaki Ekran Çözünürlüğü kaydırıcısı uygulanmalı ISelectionProvider ve alt öğeleri hem ISelectionItemProviderhem de IRawElementProviderFragment uygulamalıdır.
ISelectionItemProvider için Gerekli Üyeler
uygulamak ISelectionItemProvideriçin aşağıdaki özellikler, yöntemler ve olaylar gereklidir.
Gerekli üyeler | Üye türü | Notlar |
---|---|---|
CanSelectMultiple | Özellik | Hiçbiri |
IsSelectionRequired | Özellik | Hiçbiri |
GetSelection | Metot | Hiçbiri |
InvalidatedEvent | Etkinlik | Kapsayıcıdaki bir seçim önemli ölçüde değiştiğinde ve sabit izinlerden daha fazla ElementSelectedEvent ve ElementRemovedFromSelectionEvent olay göndermeyi gerektirdiğinde InvalidateLimit tetiklendi. |
- bir , veya öğesinin Selectsonucu seçili tek bir öğeyse, ElementSelectedEvent bir yükseltilmelidir; aksi takdirde uygun şekilde gönderilmelidirElementRemovedFromSelectionEventElementAddedToSelectionEvent/ .RemoveFromSelectionAddToSelection
Özel durumlar
Sağlayıcıların aşağıdaki özel durumları oluşturması gerekir.
Özel durum türü | Koşul |
---|---|
InvalidOperationException | Aşağıdakilerden herhangi biri denendiğinde: - RemoveFromSelection , ve öğesinin zaten seçili olduğu IsSelectionRequiredProperty = true tek seçimli bir kapsayıcıda çağrılır.- RemoveFromSelection , ve yalnızca bir öğenin seçildiği IsSelectionRequiredProperty = true çok seçimli bir kapsayıcıda çağrılır.- AddToSelection , ve başka bir öğenin zaten seçili olduğu CanSelectMultipleProperty = false tek seçimli bir kapsayıcıda çağrılır. |