Implementacja wzorca formantu przełącznika 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 IToggleProvider, w tym informacje o metodach i właściwościach. Linki do dodatkowych odwołań znajdują się na końcu tematu.

Wzorzec kontrolki TogglePattern służy do obsługi kontrolek, które mogą przechodzić przez zestaw stanów i obsługiwać stan po ustawieniu. Przykłady kontrolek implementujących ten wzorzec kontrolki 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 przełączania należy zwrócić uwagę na następujące wytyczne i konwencje:

  • Kontrolki, które nie zachowują stanu po aktywowaniu, takie jak przyciski, przyciski paska narzędzi i hiperlinki, muszą zamiast tego implementować IInvokeProvider .

  • Kontrolka musi przechodzić przez nią ToggleState w następującej kolejności: On, Off i, jeśli jest obsługiwana, Indeterminate.

  • TogglePattern nie udostępnia metody SetState(newState) ze względu na problemy związane z bezpośrednim ustawieniem trójstanowej skrzynki kontrolnej bez przechodzenia na rowerze przez odpowiednią ToggleState sekwencję.

  • Kontrolka RadioButton nie implementuje IToggleProviderelementu , ponieważ nie jest w stanie jeździć na rowerze przez jego prawidłowe stany.

Wymagane elementy członkowskie dla IToggleProvider

Następujące właściwości i metody są wymagane do zaimplementowania IToggleProvidermetody .

Wymagany element członkowski Typ elementu członkowskiego Uwagi
Toggle Method Brak
ToggleStateProperty Właściwości Brak

Ten wzorzec kontrolki nie ma skojarzonych zdarzeń.

Wyjątki

Ten wzorzec kontrolki nie ma skojarzonych wyjątków.

Zobacz też