Implementacja wzorca formantu SelectionItem dla automatyzacji interfejsu użytkownika
Uwaga
Ta dokumentacja jest przeznaczona dla deweloperów programu .NET Framework, którzy chcą używać zarządzanych klas automatyzacja interfejsu użytkownika zdefiniowanych w System.Windows.Automation przestrzeni nazw. Aby uzyskać najnowsze informacje na temat automatyzacja interfejsu użytkownika, zobacz Interfejs API usługi Windows Automation: automatyzacja interfejsu użytkownika.
W tym temacie przedstawiono wytyczne i konwencje implementacji ISelectionItemProvider, w tym informacje o właściwościach, metodach i zdarzeniach. Linki do dodatkowych odwołań znajdują się na końcu przeglądu.
Wzorzec kontrolki SelectionItemPattern służy do obsługi kontrolek, które działają jako pojedyncze, wybieralne elementy podrzędne kontrolek kontenera, które implementują ISelectionProviderelement . Przykłady kontrolek implementujących wzorzec kontrolki SelectionItem można znaleźć w temacie Control Pattern Mapping for automatyzacja interfejsu użytkownika Clients (Mapowanie wzorca kontrolek dla klientów automatyzacja interfejsu użytkownika)
Wytyczne i konwencje implementacji
Podczas implementowania wzorca kontrolki Element zaznaczenia należy pamiętać o następujących wytycznych i konwencjach:
- Kontrolki wyboru jednokrotnego, które zarządzają kontrolkami podrzędnymi, które implementują IRawElementProviderFragmentRootkontrolki , takie jak suwak Rozdzielczość ekranu w oknie dialogowym Właściwości wyświetlania, powinny implementować ISelectionProviderIRawElementProviderFragmentISelectionItemProviderelementy podrzędne i .
Wymagane elementy członkowskie dla ISelectionItemProvider
Następujące właściwości, metody i zdarzenia są wymagane do zaimplementowania ISelectionItemProviderelementu .
| Wymagane elementy członkowskie | Typ elementu członkowskiego | Uwagi |
|---|---|---|
| CanSelectMultiple | Właściwości | Brak |
| IsSelectionRequired | Właściwości | Brak |
| GetSelection | Method | Brak |
| InvalidatedEvent | Zdarzenie | Zgłaszane, gdy wybór w kontenerze uległ znacznej zmianie i wymaga wysyłania większej InvalidateLimit liczby ElementSelectedEventElementRemovedFromSelectionEvent zdarzeń niż stałe zezwolenia. |
- Jeśli wynik Selectelementu , , AddToSelectionlub RemoveFromSelection jest jednym wybranym elementem, ElementSelectedEvent element powinien zostać zgłoszony; w przeciwnym razie wyślij ElementAddedToSelectionEvent/ ElementRemovedFromSelectionEvent odpowiednio.
Wyjątki
Dostawcy muszą zgłaszać następujące wyjątki.
| Typ wyjątku | Stan |
|---|---|
| InvalidOperationException | Gdy zostanie podjęta dowolna z następujących prób: - RemoveFromSelection Element jest wywoływany w kontenerze z pojedynczym wyborem, w którym IsSelectionRequiredProperty = true element jest już zaznaczony.- RemoveFromSelection Element jest wywoływany w kontenerze wielokrotnego wyboru, w którym IsSelectionRequiredProperty = true zaznaczono tylko jeden element.- AddToSelection element jest wywoływany w kontenerze z jednym wyborem, gdzie CanSelectMultipleProperty = false i inny element jest już zaznaczony. |
Zobacz też
- Wzorce kontrolek automatyzacji interfejsu użytkownika — omówienie
- Obsługa wzorców kontrolek dostawcy automatyzacji interfejsu użytkownika
- Wzorce kontrolek automatyzacji interfejsu użytkownika dla klientów
- Implementacja wzorca kontrolki wyboru automatyzacji interfejsu użytkownika
- Przegląd drzewa automatyzacji interfejsu użytkownika
- Używanie buforowania w automatyzacji interfejsu użytkownika
- Przykład dostawcy fragmentów