UI Otomasyon Seçim Denetim Düzenini 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 konu başlığında, olaylar ve özellikler hakkında bilgiler de dahil olmak üzere uygulama ISelectionProvideryönergeleri ve kuralları tanıtılmaktadır. Ek başvuruların bağlantıları, konunun sonunda listelenir.
Denetim SelectionPattern düzeni, seçilebilir alt öğeler koleksiyonu için kapsayıcı görevi üstleyen denetimleri desteklemek için kullanılır. Bu öğenin alt öğelerinin uygulaması ISelectionItemProvidergerekir. Bu denetim desenini uygulayan denetim örnekleri için bkz. UI Otomasyonu İstemcileri için Denetim Düzeni Eşlemesi.
Uygulama Yönergeleri ve Kuralları
Seçim denetim desenini uygularken aşağıdaki yönergelere ve kurallara dikkat edin:
Uygulayan ISelectionProvider denetimler, tek veya birden çok alt öğenin seçilmesine izin verir. Örneğin, liste kutusu, liste görünümü ve ağaç görünümü birden çok seçimi desteklerken birleşik giriş kutusu, kaydırıcı ve radyo düğmesi grubu tek seçimi destekler.
Ses düzeyi kaydırıcısı denetimi gibi en düşük, en yüksek ve sürekli aralığa sahip denetimler ISelectionProvideryerine uygulanmalıdırIRangeValueProvider.
Microsoft Word'den Ekran Çözünürlüğü kaydırıcısı veya Microsoft Word'den Renk Seçici seçim denetimi (aşağıda gösterilmiştir) gibi uygulayan IRawElementProviderFragmentRootalt denetimleri yöneten tek seçimli denetimler uygulanmalıdırISelectionProvider; alt öğeleri hem hem ISelectionItemProviderde IRawElementProviderFragment uygulamalıdır.
Renk Renk Örneği Dizesi Eşleme Örneği
- Menüler'i desteklemez SelectionPattern. Hem grafik hem de metin içeren menü öğeleriyle (Microsoft Outlook'ta Görünüm menüsündeki Önizleme Bölmesi öğeleri gibi) çalışıyorsanız ve durumu iletmeniz gerekiyorsa, uygulamanız IToggleProvidergerekir.
ISelectionProvider için Gerekli Üyeler
Arabirim için ISelectionProvider aşağıdaki özellikler, yöntemler ve olaylar gereklidir.
| Gerekli üyeler | Tür | Notlar |
|---|---|---|
| CanSelectMultiple | Özellik | ve RemoveAutomationPropertyChangedEventHandlerkullanarak AddAutomationPropertyChangedEventHandler özellik değişikliği olaylarını desteklemelidir. |
| IsSelectionRequired | Özellik | ve RemoveAutomationPropertyChangedEventHandlerkullanarak AddAutomationPropertyChangedEventHandler özellik değişikliği olaylarını desteklemelidir. |
| GetSelection | Metot | Hiçbiri |
| InvalidatedEvent | Etkinlik | Kapsayıcıdaki bir seçim önemli ölçüde değiştiğinde ve sabit izinlerden daha fazla toplama ve kaldırma olayı göndermeyi gerektirdiğinde InvalidateLimit tetiklendi. |
IsSelectionRequired ve CanSelectMultiple özellikleri dinamik olabilir. Örneğin, bir denetimin ilk durumunda varsayılan olarak seçili öğe olmayabilir ve bu, öğesinin olduğunu IsSelectionRequiredfalsegösterir. Ancak, bir öğe seçildikten sonra, denetimde her zaman en az bir öğe seçilmelidir. Benzer şekilde, nadir durumlarda, bir denetim başlatma sırasında birden çok öğenin seçilmesine izin verebilir, ancak daha sonra yalnızca tek seçimlerin yapılmasına izin verebilir.
Özel durumlar
Sağlayıcıların aşağıdaki özel durumları oluşturması gerekir.
| Özel Durum Türü | Koşul |
|---|---|
| ElementNotEnabledException | Denetim etkin değilse. |
| InvalidOperationException | Denetim gizliyse. |