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