Udostępnij za pomocą


Implementowanie wzorca kontrolki przełącznika Automatyzacji Interfejsu Użytkownika

Uwaga / Notatka

Ta dokumentacja jest przeznaczona dla deweloperów programu .NET Framework, którzy chcą używać zarządzanych klas automatyzacji interfejsu użytkownika zdefiniowanych w przestrzeni nazw System.Windows.Automation. Aby uzyskać najnowsze informacje na temat automatyzacji interfejsu użytkownika, zobacz Windows Automation API: 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 utrzymywać stan po ustawieniu. Przykłady kontrolek implementujących ten wzorzec kontrolki można znaleźć w temacie Control Pattern Mapping for UI Automation Clients.

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ójstanowego CheckBox bez przechodzenia przez odpowiednią ToggleState sekwencję.

  • Kontrolka RadioButton nie implementuje IToggleProvider, ponieważ nie jest w stanie przechodzić przez swoje prawidłowe stany.

Członkowie wymagani dla IToggleProvider

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

Wymagany członek Typ członkostwa Notatki
Toggle Metoda Żaden
ToggleStateProperty Majątek Żaden

Ten wzorzec kontrolki nie ma skojarzonych zdarzeń.

Wyjątki

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

Zobacz także