Udostępnij za pośrednictwem

Implementacja wzorca kontrolki MultipleView dla automatyzacji interfejsu użytkownika

  • Artykuł

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 IMultipleViewProvider, w tym informacje o zdarzeniach i właściwościach. Linki do dodatkowych odwołań znajdują się na końcu tematu.

Wzorzec MultipleViewPattern kontrolki jest używany do obsługi kontrolek, które zapewniają i mogą przełączać się między wieloma reprezentacjami tego samego zestawu informacji lub kontrolek podrzędnych.

Przykłady kontrolek, które mogą przedstawiać wiele widoków, obejmują widok listy (który może wyświetlać jego zawartość jako miniatury, kafelki, ikony lub szczegóły), wykresy programu Microsoft Excel (kołowe, liniowe, słupkowy, wartość komórki z formułą), dokumenty programu Microsoft Word (normalny, układ wydruku, układ wydruku, układ do czytania, konspekt), kalendarz programu Microsoft Outlook (rok, miesiąc, tydzień, dzień) i skórki microsoft Odtwarzacz multimedialny Windows. Obsługiwane widoki są określane przez dewelopera kontrolek i są specyficzne dla każdej kontrolki.

Wytyczne i konwencje implementacji

Podczas implementowania wzorca kontrolki Wiele widoków należy pamiętać o następujących wytycznych i konwencjach:

  • IMultipleViewProvider należy również zaimplementować w kontenerze, który zarządza bieżącym widokiem, jeśli różni się od kontrolki, która udostępnia bieżący widok. Na przykład Eksplorator Windows zawiera kontrolkę Lista dla bieżącej zawartości folderu, podczas gdy widok kontrolki jest zarządzany z poziomu aplikacji Eksploratora Windows.

  • Kontrolka, która może sortować jego zawartość, nie jest uznawana za obsługę wielu widoków.

  • Kolekcja widoków musi być identyczna w przypadku wystąpień.

  • Nazwy widoków muszą być odpowiednie do użycia w aplikacjach zamiany tekstu na mowę, Braille'a i innych aplikacji czytelnych dla człowieka.

Wymagane elementy członkowskie dla elementu IMultipleViewProvider

Do implementowania elementu IMultipleViewProvider wymagane są następujące właściwości i metody.

Wymagane elementy członkowskie Typ elementu członkowskiego Uwagi
CurrentView Właściwości Brak
GetSupportedViews Method Brak
GetViewName Method Brak
SetCurrentView Method Brak

Brak zdarzeń skojarzonych z tym wzorcem kontrolki.

Wyjątki

Dostawca musi zgłaszać następujące wyjątki.

Typ wyjątku Stan
ArgumentException W przypadku wywołania elementu SetCurrentView lub GetViewName z parametrem, który nie jest elementem członkowskim obsługiwanej kolekcji widoków.

Zobacz też