Реализация шаблона элемента управления переключателем в автоматизации пользовательского интерфейса

Замечание

Эта документация предназначена для разработчиков .NET Framework, которые хотят использовать управляемые классы автоматизации пользовательского интерфейса, определенные в пространстве имен System.Windows.Automation. Последние сведения об автоматизации пользовательского интерфейса см. в разделе API автоматизации Windows: автоматизация пользовательского интерфейса.

В этом разделе приводятся рекомендации и соглашения о реализации IToggleProvider, включая сведения о методах и свойствах. Ссылки на дополнительные ссылки перечислены в конце раздела.

Шаблон TogglePattern элемента управления используется для поддержки элементов управления, которые могут выполнять циклический цикл по набору состояний и поддерживать состояние после установки. Примеры элементов управления, реализующих этот шаблон, см. в разделе Сопоставление шаблонов элементов управления для клиентов автоматизации пользовательского интерфейса.

Рекомендации по реализации и соглашения

При реализации шаблона элемента управления Toggle обратите внимание на следующие рекомендации и соглашения:

• Элементы управления, которые не поддерживают состояние при активации, например кнопки, кнопки панели инструментов и гиперссылки, должны реализовываться IInvokeProvider вместо этого.

• Элемент управления должен проходить цикл через ToggleState в следующем порядке: On, Off и, если он поддерживается, Indeterminate.

• TogglePattern не предоставляет метод SetState(newState) из-за проблем, связанных с прямым заданием три-состояния флажка CheckBox без прохода через соответствующую ToggleState последовательность.

• Элемент управления RadioButton не реализует IToggleProvider, потому что он не может переключаться между допустимыми состояниями.

Требуемые члены для IToggleProvider

Для реализации IToggleProviderнеобходимы следующие свойства и методы.

Обязательный член	Тип участника	Примечания.
Toggle	Метод	Отсутствует
ToggleStateProperty	Недвижимость	Отсутствует

Этот шаблон элемента управления не имеет связанных событий.

Исключения

Этот шаблон элемента управления не имеет связанных исключений.

См. также

• Обзор шаблонов управления автоматизацией пользовательского интерфейса
• Поддержка шаблонов управления в поставщике автоматизации пользовательского интерфейса
• Шаблоны элементов управления автоматизации пользовательского интерфейса для клиентов
• Получение состояния переключателя флажка с помощью автоматизации пользовательского интерфейса
• Обзор дерева автоматизации пользовательского интерфейса
• Использование кэширования в автоматизации пользовательского интерфейса