Seçim Denetimi Deseni
ISelectionProvideruygulamaya yönelik özellikler, yöntemler ve olaylar hakkında bilgiler de dahil olmak üzere yönergeler ve kurallar açıklanmaktadır. Seçimi denetim düzeni, seçilebilir alt öğeler koleksiyonu için kapsayıcı görevi üstleyen denetimleri desteklemek için kullanılır. Bu öğenin alt öğeleri ISelectionItemProvideruygulamalıdı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ı
- ISelectionProvideriçin Gerekli Üyeleri
- İlgili konular
Uygulama Yönergeleri ve Kuralları
Seçimi denetim desenini uygularken aşağıdaki yönergelere ve kurallara dikkat edin:
ISelectionProvider uygulayan denetimler, tek veya birden çok alt öğenin seçilmesine izin verir. Örneğin, liste kutuları, liste görünümleri ve ağaç görünümleri birden çok seçimi desteklerken birleşik giriş kutuları, kaydırıcılar ve radyo düğmesi grupları tek seçimi destekler.
Medya yürütücüsünün Birimi kaydırıcı denetimi gibi en düşük, en yüksek ve sürekli aralığa sahip denetimler, ISelectionProvideryerine IRangeValueProvider uygulamalıdır.
Windows için Görüntü Özellikleri iletişim kutusundaki Ekran Çözünürlüğü kaydırıcısı veya Microsoft Word'den Renk Seçici seçim denetimi gibi IRawElementProviderFragmentRootuygulayan alt denetimleri yöneten tek seçimli denetimler ISelectionProvider; çocuklarının hem IRawElementProviderFragment hem de ISelectionItemProvideruygulaması gerekir.
Renk örneği dizesi eşleme örneğini gösteren
Menüler Seçimi denetim düzenini desteklemez. Hem grafik hem de metin içeren menü öğeleriyle çalışıyorsanız (örneğin, Önizleme Bölmesi Microsoft Outlook'ta Görünüm menüsündeki öğeler) ve durumu iletmeniz gerekiyorsa, IToggleProvideruygulamanız gerekir.
ISelectionProvider için Gerekli Üyeler
ISelectionProvider arabirimini uygulamak için aşağıdaki özellikler, yöntemler ve olaylar gereklidir.
| Gerekli üyeler | Üye türü | Notlar |
|---|---|---|
| CanSelectMultiple | Mülk | Hiç kimse |
| IsSelectionRequired | Mülk | Hiç kimse |
| GetSelection | Yöntem | Hiç kimse |
| UIA_Selection_InvalidatedEventId | Olay | Kapsayıcıdaki bir seçim önemli ölçüde değiştiğinde bu olayı tetikleyin. |
ISelectionProvider::IsSelectionRequired ve CanSelectMultiple özellikleri dinamik olabilir. Örneğin, bir denetimin ilk durumunda varsayılan olarak seçili öğe olmayabilir ve isselectionRequired false olduğunu gö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.
İlgili konular