Wzorzec kontrolki SelectionItem
Opisuje wytyczne i konwencje implementowania ISelectionItemProvider, w tym informacje o właściwościach, metodach i zdarzeniach. Wzorzec kontrolki SelectionItem służy do obsługi kontrolek, które działają jako poszczególne elementy podrzędne kontrolek kontenera, które implementują ISelectionProvider.
Aby zapoznać się z przykładami kontrolek implementujących ten wzorzec kontrolki, zobacz typy kontrolek i obsługiwane wzorce kontrolek.
Ten temat zawiera następujące sekcje.
- wytyczne i konwencje implementacji
- wymagane elementy członkowskie ISelectionItemProvider
- Tematy pokrewne
Wytyczne i konwencje implementacji
Podczas implementowania wzorca kontrolki SelectionItem należy pamiętać o następujących wytycznych i konwencjach:
- Kontrolki wyboru jednokrotnego, które zarządzają kontrolkami podrzędnym, które implementują IRawElementProviderFragmentRoot, takie jak suwak rozdzielczość ekranu w oknie dialogowym właściwości wyświetlania wyświetlania systemu Windows, powinny implementować ISelectionProvider; ich elementy podrzędne powinny implementować IRawElementProviderFragment i ISelectionItemProvider.
Wymagane elementy członkowskie ISelectionItemProvider
Następujące właściwości, metody i zdarzenia są wymagane do zaimplementowania interfejsu ISelectionItemProvider.
| Wymagane elementy członkowskie | Typ elementu członkowskiego | Notatki |
|---|---|---|
| AddToSelection | Metoda | Żaden |
| isSelected | Własność | Żaden |
| RemoveFromSelection | Metoda | Żaden |
| Wybierz | Metoda | Żaden |
| SelectionContainer | Własność | Żaden |
| UIA_SelectionItem_ElementAddedToSelectionEventId | Zdarzenie | Żaden |
| UIA_SelectionItem_ElementRemovedFromSelectionEventId | Zdarzenie | Żaden |
| UIA_SelectionItem_ElementSelectedEventId | Zdarzenie | Żaden |
Jeśli wynik Select, AddToSelectionlub RemoveFromSelection jest jednym wybranym elementem, należy podnieść zdarzenie ElementSelected (UIA_SelectionItem_ElementSelectedEventId). w przeciwnym razie zgłoś ElementAddedToSelection (UIA_SelectionItem_ElementAddedToSelectionEventId) lub ElementRemovedFromSelection (UIA_SelectionItem_ElementRemovedFromSelectionEventId) odpowiednio.
Tematy pokrewne
-
Wzorce kontrolek automatyzacji interfejsu użytkownika — omówienie