实现 UI 自动化 Toggle 控件模式

注意
本文档的目标读者是欲使用 System.Windows.Automation 命名空间中定义的托管 UI Automation类的 .NET Framework 开发人员。有关 UI Automation的最新信息，请参见 Windows Automation API: UI Automation（Windows 自动化 API：UI 自动化）。

本主题介绍实现 IToggleProvider 的准则和约定，包括有关方法和属性的信息。本主题的结尾列出了指向其他参考资料的链接。

TogglePattern 控件模式用于支持可以循环通过一组状态并在设置后保持某种状态的控件。有关实现此控件模式的控件示例，请参见 UI 自动化客户端的控件模式映射。

本主题包括下列各节。

实现准则和约定

实现 Toggle 控件模式时，请注意以下准则和约定：

在激活时不保持状态的控件（如按钮、工具栏按钮和超链接）必须实现 IInvokeProvider。
控件必须按以下顺序循环通过其 ToggleState：On、Off 和 Indeterminate。
TogglePattern 不提供 SetState(newState) 方法，因为直接设置三态复选框而不循环通过其相应的 ToggleState 序列会导致相关问题。
RadioButton 控件不实现 IToggleProvider，因为它无法循环通过其有效状态。