Udostępnij za pośrednictwem


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:

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.

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ż